cnb-rs config unset

cnb-rs config unset <key>

清除指定配置项的值，使其回退到默认值。

cnb-rs 端独有的命令，gh 端需要通过 gh config set <key> "" 模拟，cnb-rs 端用专门命令避免「空字符串」与「未设置」的语义混淆。

行为细节

• 若 key 原本已设置：从 ~/.cnb/config.toml 删除对应字段，输出 ✓ 已清除 <key>
• 若 key 原本就未设置：friendly 提示 <key> 本就未设置，无需清除，仍返回 exit code 0（幂等）
• 若 key 不在合法列表：friendly bail + 列出全部可用 key
• 嵌套 key（templates.*）的最后一个子项被清后，[templates] 整段也会被删除以保持配置文件整洁

参数

• <key>: 配置项名称。可选值：
  • domain
  • git_protocol
  • templates.gitignore_repo
  • templates.license_repo

示例

# 清除已设置的 key
$ cnb-rs config unset templates.gitignore_repo
✓ 已清除 templates.gitignore_repo

# 再次 unset 同一个 key（幂等）
$ cnb-rs config unset templates.gitignore_repo
templates.gitignore_repo 本就未设置，无需清除

# unset 后 list 看到回退到 default
$ cnb-rs config list
domain = cnb.cool (default)
git_protocol = https (default)
templates.gitignore_repo = wwvo/cnb-rs/gitignore-templates (default)
templates.license_repo = wwvo/cnb-rs/license-templates (default)

# 未知 key → friendly bail
$ cnb-rs config unset foo
错误: 未知配置项：foo
可用配置项：domain, git_protocol, templates.gitignore_repo, templates.license_repo

另请参阅

• cnb-rs config
• cnb-rs config set
• cnb-rs config list