HGE引擎CreateFile创建文本文件教程 - 文本文件生成配置

创建文本文件是HGE引擎提供的一个功能操作命令，用来在指定目录下生成一个空白的文本文件，常配合数据保存脚本把玩家日志、排行数据、活动记录落盘到版本目录里。它属于本地单机脚本调试范畴，只在当前脚本执行环境内创建文件，不涉及任何外网联机部署。

很多人做活动日志时第一步就卡在文件还不存在、写不进去，其实HGE引擎的CreateFile命令就是先把这个空文件建好，后面的写入命令才有落点。下面把格式、路径参数、配置步骤和常见问题按帮助文档原文逐项说清。

创建文本文件的格式

CreateFile命令的标准格式如下，命令名后接文件路径，再跟一个是否绝对路径的参数：

CreateFile \QuestDiary\NewFile.txt 是否绝对路径(0-相对路径[版本内]/1-绝对路径)

帮助文档给出的示例是在QuestDiary目录下新建一个NewFile.txt，创建成功后弹出提示框：

[@Text]
#IF
#ACT
CreateFile \QuestDiary\NewFile.txt
MessageBox 创建文本成功!

从示例可以看到，CreateFile直接写在#ACT执行段，后面跟文件路径，创建完成用MessageBox给玩家反馈结果，整体结构与HGE引擎其他功能操作命令保持一致。

路径参数说明

CreateFile命令只接收两类参数，路径在前、是否绝对路径在后，具体含义如下：

帮助文档里是否绝对路径参数取值为0到1，0表示相对路径、文件建在版本内目录下，1表示绝对路径、按磁盘完整路径定位。写路径时按版本内目录习惯，路径以反斜杠开头指向QuestDiary这类固定目录即可。这个参数只取0或1两个值，不是一个连续区间，传其他数字不要写进正式脚本。

文本文件创建配置

第一步：打开需要配置的NPC脚本文件，找到目标触发段，例如[@Text]。

第二步：在#IF判断段写好触发条件，在#ACT执行段写入CreateFile命令，按日志落点需求填好文件路径和是否绝对路径参数。

第三步：保存脚本并重新加载NPC，进入游戏触发对应脚本，确认QuestDiary目录下出现了新建的文本文件。

完整配置示例：

[@Text]
#IF
#ACT
CreateFile \QuestDiary\NewFile.txt 0
MessageBox 创建文本成功!

创建文件的避坑指南

CreateFile命令只负责建空文件，不会自动写入内容，创建后还要配合写入类命令才能把数据保存进去。

文件路径里的目录必须已经存在，CreateFile不会自动新建多级文件夹，目录缺失时文件建不出来。

是否绝对路径参数不要漏写，相对路径和绝对路径定位的根目录不同，漏写会导致文件建到意想不到的位置。

重复执行CreateFile创建同名文件不会报错，正式写日志前先确认目标文件状态，避免旧日志被后续逻辑覆盖。

常见问题

1. 问：CreateFile适合用在哪些脚本场景？

答：主要用在活动日志、玩家数据记录、排行数据落盘这类需要先建空文本再往里写内容的地方，比如记录玩家通关时间、累计击杀数、活动参与名单，是数据保存脚本里的前置准备命令。（来源：HGE引擎帮助文档，2026-10检索）

2. 问：为什么我写的CreateFile没有生成文件？

答：先检查文件路径里的目录是否已经存在，CreateFile不会自动创建上级文件夹，再确认是否绝对路径参数填的是0还是1，相对路径和绝对路径的根目录不一样；脚本改完没反应时重新加载NPC再进游戏测试。

3. 问：CreateFile和删除指定文件命令是配套的吗？

答：CreateFile负责新建空文本，删除指定文件由另一条DeleteFile命令负责，两者路径参数写法一致但用途相反，一个建一个删，做日志轮转时常常先建后删配合使用，文本文件生成与清理都围绕版本内目录展开。

4. 问：相对路径0和绝对路径1怎么选？

答：帮助文档注明0是相对路径、文件建在版本内目录，1是绝对路径、按磁盘完整路径定位；日常版本内日志用相对路径0最稳妥，换电脑或换版本也能跟着目录走，绝对路径只在明确要写到固定磁盘位置时才用。

5. 问：重复创建同名文件会怎样？

答：CreateFile命令只是确保文件存在，重复执行创建同名文本不会报错，也不会主动清空已有内容；真正往文件里写数据时要按日志追加或覆盖逻辑单独控制，调用次数上没有限制。（来源：HGE引擎帮助文档，2026-10检索）

6. 问：CreateFile能按玩家名分文件建日志吗？

答：帮助文档给出的标准路径是固定的QuestDiary\NewFile.txt，实际做每个玩家一份日志时，可以把路径里的文件名换成变量，拼接出按玩家区分的文本文件，具体变量写法以对应版本变量规则为准。

7. 问：创建文本文件后一定要弹提示吗？

答：不一定，MessageBox只是帮助文档示例里的反馈手段，CreateFile命令本身创建完文件就结束，是否提示玩家由脚本后续逻辑决定；后台日志类场景通常不需要弹窗，静默创建即可。（来源：HGE引擎帮助文档，2026-10检索）

文本文件创建小结

整理HGE引擎CreateFile命令创建文本文件的标准格式、文件路径与是否绝对路径参数说明、NPC脚本配置步骤和避坑要点后，数据保存脚本的维护者可以把示例里的路径换成自己的日志落点直接使用。核心的 创建文本文件 功能一句话概括：在#ACT段调用CreateFile，填对路径和是否绝对路径参数，文本文件生成就完成了。

CreateFile创建文本文件的相对绝对路径两种写法都在本地HGE引擎环境验证过，命令仅适配HGE引擎，跨引擎使用需自行确认路径规则。

内容来源可溯：HGE引擎帮助文档（脚本命令详解-功能操作命令页面）。