JSON
从文件初始化 JSON
从 JSON 文件加载内容到目标标识,适用于外部配置读取、活动模板载入和脚本与文件数据联动。
命令用途
Json-InitJsonFromFile 对应的实际命令写法是 JSON <标识> InitJsonFromFile,用于从 JSON 文件加载内容到目标标识。
它适合读取外部配置、活动模板和需要长期维护在文件里的结构化数据。
命令名
Json-InitJsonFromFile
调用格式
JSON <标识> InitJsonFromFile <文件路径>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要初始化的 JSON 标识。可写 标识|-1 表示不过期。 |
InitJsonFromFile | 是 | 固定子命令,表示从文件初始化。 |
文件路径 | 是 | JSON 文件路径。 |
返回或影响
- 该命令会把文件中的 JSON 内容读入目标标识。
- 适合把外部配置和脚本处理逻辑结合起来。
- 文件加载成功后,后续可按普通 JSON 标识继续判断、读取和修改。
示例
基础用法
#ACT
JSON 活动配置|-1 InitJsonFromFile ..\JsonData\activity.json
这段写法会把外部 activity.json 文件初始化到一个不过期的 活动配置 标识中。
常见变体
#ACT
JSON 临时结果 InitJsonFromFile ..\JsonData\example.json
这类写法适合在当前流程中临时载入一份 JSON 文件结果,再继续读取或加工。
注意事项
- 文件路径写错、文件不存在或文件内容不是合法 JSON 时,后续读取结果通常不会符合预期。
- 当配置需要长期驻留内存时,可以用
标识|-1的写法避免过期。 - 如果数据本来就已经在脚本里,或者只是一小段临时对象,
Json-InitJson会更直接。
