`json`

json 通过点路径读取、搜索和修改嵌套 JSON，并保留值类型。写入后会重新验证文档并以规范化 JSON 保存。

数据版本 1.3.5稳定

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.jsonname lil-sandbox debug true features.0 files features.1 code features.2 archivesjson $ -cValid JSONjson $ -f "files" -vfeatures.0 files

概览

json 直接操作嵌套 JSON：用点路径定位节点，搜索键或值，从文字或文件原子写入一个值，验证文档，并在不使用会话缓冲区的情况下查看规范化 JSON。

路径选中节点，类型仍然是类型

命令操作的是结构而不是文本片段。limits.history 定位一个嵌套节点，-w 修改该路径，: 后的合法 JSON 值仍会保持数字、布尔值、null、数组或对象类型。

语法

lil-terminal

json <file> [key|options] · json dump <file>

参考

json <file>

显示 JSON 数据

json <file> <key>

显示一个精确的点路径

json dump <file>

显示规范化的 JSON 源文本

-f <text|mask> [-k|-v]

在键或值中查找匹配项；* 和 ? 表示掩码

-w <key> : <value>

直接把值写入文件

-w <key> < <file>

写入从另一个文件读取的值

-d <key>

按点路径删除值

-c

验证 JSON 文件

当前文件

在当前 core 中，成功打开的文件会立即可通过 $ 再次引用。如果此模块是该扩展名已安装的最高优先级处理器，只输入文件名即可由此命令打开。这些是 core 提供的便捷机制；json <file> 仍是明确调用形式。

搜索

-f 同时搜索路径和值。仅搜索键时加 -k，仅搜索值时加 -v。包含 * 或 ? 的查询按掩码处理。

直接编辑

-w 会立即写入文件。: 后直接给出值；< <file> 从另一个文件读取值。-d 删除一个点路径。

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示；服务器不会执行任何终端命令。

打开文件并通过 $ 继续使用

安装与管理

安装当前兼容版本。完整功能请选择 Base，精简包请选择 Minimum；已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install json

Minimum 包

安装精简包。该包不包含本地参考；help <cmd> -i 会打开当前服务器参考。

install json -m

精确公开版本

安装这个确切的已发布版本。

install json -v 1.3.5

检查或升级

让 upgrade 检查兼容性，仅在需要时替换已安装块。

upgrade json

删除模块

删除扩展块，不影响核心和其他模块。

install json -u

示例

示例可复制，但网站不会执行。请先检查路径、权限和破坏性选项。

打开文件并通过 $ 继续使用

cd \sandbox\config | json app.json

name             lil-sandbox
debug            true
features.0       files
features.1       code
features.2       archives
limits.upload_mb 2
limits.history   25

显示 JSON 数据

app.json

name             lil-sandbox
debug            true
features.0       files
features.1       code
features.2       archives
limits.upload_mb 2
limits.history   25

显示一个精确的点路径

json $ limits.history

Json · find-key

json $ -f "upload" -k

limits.upload_mb  2

Json · find-value

json $ -f "files" -v

features.0  files

Json · write

json $ -w limits.password : "Ed1g!fs:13od"

limits.password  Ed1g!fs:13od

Json · file-value

json $ -w limits.policy < value.json

limits.policy.rotate    true
limits.policy.attempts  5

Json · delete

json $ -d limits.password

limits.upload_mb  2
limits.history    25

Json · validate

json $ -c

Valid JSON

显示规范化的 JSON 源文本

json dump $ > json-review.json -r

{
  "name": "lil-sandbox",
  "debug": true,
  "features": ["files", "code", "archives"],
  "limits": {"upload_mb": 2, "history": 25}
}

处理不存在的文件

json \sandbox\config\missing.json

未找到文件

本示例使用的文件: `sandbox/config/app.json`

该示例使用受保护的 /sandbox/ 文档工作区中的文件或目录。

{
  "name": "lil-sandbox",
  "debug": true,
  "features": ["files", "code", "archives"],
  "limits": {
    "upload_mb": 2,
    "history": 25
  }
}

当前公开版本

v1.3.52026-08-11

统一的结构化数据帮助

读取、搜索、写入、删除和校验统一采用同一组选项格式。

# 版本历史

json

概览