`yml`

yml 处理适合配置文件的紧凑 YAML 子集：嵌套映射、标量和简单列表可通过点路径读取、搜索和修改。

数据版本 1.1.5稳定

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.ymlapplication.name lil-shop application.debug true database.host localhost database.port 3306 database.options.0 utf8mb4yml $ -cValid YAMLyml dump $application: name: lil-shop debug: true database: host: localhost

概览

yml 面向常见 YAML 配置提供紧凑的文件直操作流程：点路径、搜索、修改或删除一个值、验证受支持的子集，以及通过 dump 查看完整源文本。

缩进会变成点路径

解析器有意保持严格：不支持制表符，也不支持 - item 形式的块列表。对不熟悉的 YAML 先用 -c 验证；复杂文档应使用 edit 或 code。

语法

lil-terminal

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

参考

yml <file>

显示 YAML 数据

yml <file> <key>

显示一个精确的点路径

yml dump <file>

显示规范化的 YAML 源文本

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

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

-w <key> : <value>

直接把值写入文件

-w <key> < <file>

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

-d <key>

按点路径删除值

-c

验证 YAML 文件

当前文件

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

搜索

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

直接编辑

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

格式范围

该模块有意只实现共享主机中常用的配置格式子集。高级格式特性应使用 edit 或 code 按文本编辑，避免静默地重新解释。

交互式 sandbox 预览

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

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

安装与管理

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

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

Base 包

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

install yml

Minimum 包

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

install yml -m

精确公开版本

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

install yml -v 1.1.5

检查或升级

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

upgrade yml

删除模块

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

install yml -u

示例

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

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

cd \sandbox\config | yml app.yml

application.name      lil-shop
application.debug     true
database.host         localhost
database.port         3306
database.options.0    utf8mb4
database.options.1    strict

显示 YAML 数据

app.yml

application.name      lil-shop
application.debug     true
database.host         localhost
database.port         3306
database.options.0    utf8mb4
database.options.1    strict

显示一个精确的点路径

yml $ database.host

localhost

Yml · find-key

yml $ -f "database*" -k

database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict

Yml · find-value

yml $ -f "strict" -v

database.options.1  strict

Yml · write

yml $ -w database.password : "Ed1g!fs:13od"

database.password  Ed1g!fs:13od

Yml · delete

yml $ -d database.password

database.host  localhost
database.port  3306

Yml · validate

yml $ -c

Valid YAML

显示规范化的 YAML 源文本

yml dump $

application:
  name: lil-shop
  debug: true
database:
  host: localhost
  port: 3306

处理不存在的文件

yml \sandbox\config\missing.yml

未找到文件

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

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

application:
  name: lil-shop
  debug: true
database:
  host: localhost
  port: 3306
  options: ["utf8mb4", "strict"]

当前公开版本

v1.1.52026-08-13

统一的结构化数据帮助

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

# 版本历史

yml

概览