conf

conf 用于读取和修改由键值对与分节组成的简单 .conf、.cfg 和 .env 文件。写入采用原子替换,dump 输出规范化后的配置。

数据版本 1.1.6稳定
lil-terminal

概览

conf 把简单配置文件视为结构化的“路径—值”数据:直接读取、搜索、修改或删除设置,验证受支持的语法,并查看完整的规范化文本。

无需专用格式编辑器的配置操作

database.host 表示 database 分节中的 host 键。先读取或搜索,再用 -w 只修改目标路径;如果必须保留原有注释和精确排版,请使用 edit 或 code。

语法

lil-terminal
conf <file> [key|options] · conf dump <file>

参考

conf <file>

显示配置数据

conf <file> <key>

显示一个精确的点路径

conf dump <file>

显示规范化的 conf 源文本

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

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

-w <key> : <value>

直接把值写入文件

-w <key> < <file>

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

-d <key>

按点路径删除值

-c

验证 conf 文件

当前文件

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

搜索

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

直接编辑

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

格式范围

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

它不是通用的 Nginx、Apache 或各种 .env 解析器。重复的键或节会被拒绝;重写会丢失注释和原始排版。对于复杂指令,请使用 edit 或 code。Minimum 支持查看,进一步操作需要 Base。

交互式 sandbox 预览

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

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

安装与管理

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

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

Base 包

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

install conf
Minimum 包

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

install conf -m
精确公开版本

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

install conf -v 1.1.6
检查或升级

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

upgrade conf
删除模块

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

install conf -u

示例

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

打开文件并通过 $ 继续使用
cd \sandbox\config | conf app.conf
application    shop
production     true
database.host  localhost
database.port  3306
显示配置数据
cd \sandbox\config | app.conf
application    shop
production     true
database.host  localhost
database.port  3306
显示一个精确的点路径
conf config/app.conf database.host
localhost
在键或值中查找匹配项;* 和 ? 表示掩码
conf config/app.conf -f "database.*" -k
database.host  localhost
database.port  3306
在键或值中查找匹配项;* 和 ? 表示掩码
conf config/app.conf -f "shop" -v
application  shop
在键或值中查找匹配项;* 和 ? 表示掩码
conf config/app.conf -f "production"
production  true
直接把值写入文件
conf config/app.conf -w database.port : 3307
database.port  3307
写入从另一个文件读取的值
conf config/app.conf -w application < config/plain-value.txt
application  demo-site
按点路径删除值
conf config/app.conf -d database.port
application    shop
production     true
database.host  localhost
处理不存在的文件
conf config/app.conf -c
Valid configuration
显示规范化的 conf 源文本
conf dump config/app.conf
application=shop
production=true

[database]
host=localhost
port=3306
显示一个精确的点路径
conf config/app.conf missing.key
Path not found
写入从另一个文件读取的值
conf config/app.conf -w database.extra < config/value.json
Nested configuration sections are not supported
验证 conf 文件
conf config/duplicate.conf -c
Duplicate configuration key
显示配置数据
conf config/missing.conf
File not found
直接把值写入文件
conf config/app.conf -w database.port
Value required after : or 

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

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

# common key/value configuration
application=shop
production=true

[database]
host=localhost
port=3306

相关文档

当前公开版本

v1.1.62026-11-01

生产级完善

conf 的当前稳定版本。conf 用于读取和修改由键值对与分节组成的简单 `.