chezmoi 速查表

Q: 如何开始使用 chezmoi？

运行 chezmoi init 创建源目录。用 chezmoi add ~/.bashrc 添加文件，chezmoi edit ~/.bashrc 编辑，chezmoi apply 应用更改。远程设置：chezmoi init https://github.com/$USER/dotfiles.git && chezmoi apply。

Q: 如何在 chezmoi 中使用模板？

创建以 .tmpl 结尾的文件（如 dot_bashrc.tmpl）。使用 Go 模板语法如 {{ .chezmoi.os }}、{{ .chezmoi.hostname }}，或在 .chezmoi.toml.tmpl 的 [data] 下定义自定义变量。用 chezmoi template 或 chezmoi dump 预览。

Q: chezmoi 如何管理机密？

chezmoi 支持多种机密管理器：Bitwarden (chezmoi secret bitwarden)、1Password (chezmoi secret onepassword)、KeePassXC、GPG 加密等。机密值用 {{ bitwarden "item.field" }} 等模板语法引用。GPG 加密：chezmoi add --encrypt ~/.ssh/id_rsa。

chezmoi 是一个强大的点文件管理器。将你的点文件存储在 Git 仓库中，使用 Go 模板支持跨平台配置，内置机密管理、加密和自动安装功能。

更新: 2026-07-20·28 条命令

快速开始

bash
chezmoi init https://github.com/$GITHUB_USER/dotfiles.git  # 从仓库初始化
chezmoi add ~/.bashrc                                       # 添加点文件
chezmoi edit ~/.bashrc                                      # 编辑源文件
chezmoi diff                                                 # 预览更改
chezmoi apply                                                # 应用到系统
chezmoi update                                               # 拉取并应用

安装初始化(4)

命令	难度	示例
`chezmoi init` 初始化 chezmoi 工作目录，可选指定 GitHub 源码仓库	基础	`chezmoi init https://github.com/$GITHUB_USER/dotfiles.git`
`chezmoi init --apply` 初始化并立即应用点文件到系统	基础	`chezmoi init --apply https://github.com/$GITHUB_USER/dotfiles.git`
`chezmoi upgrade` 升级 chezmoi 到最新版本	基础	`chezmoi upgrade`
`chezmoi doctor` 检查系统配置和环境兼容性	基础	`chezmoi doctor`

基本使用(6)

命令	难度	示例
`chezmoi add` 将已有的点文件加入 chezmoi 管理	基础	`chezmoi add ~/.bashrc`
`chezmoi apply` 将 chezmoi 源文件中的更改应用到系统	基础	`chezmoi apply`
`chezmoi diff` 预览 chezmoi 源文件和目标文件之间的差异	基础	`chezmoi diff`
`chezmoi status` 显示所有受管理文件的变更状态	基础	`chezmoi status`
`chezmoi verify` 验证目标文件是否与源文件一致	基础	`chezmoi verify`
`chezmoi update` 从远程仓库拉取最新更改并应用	中级	`chezmoi update`

文件管理(11)

命令	难度	示例
`chezmoi edit` 编辑源目录中的点文件	基础	`chezmoi edit ~/.bashrc`
`chezmoi remove` 从 chezmoi 管理中移除文件	基础	`chezmoi remove ~/.bashrc`
`chezmoi forget` 忘记对文件的追踪（不移除目标文件）	中级	`chezmoi forget ~/.bashrc`
`chezmoi re-add` 根据当前目标文件重新生成源文件	中级	`chezmoi re-add ~/.bashrc`
`chezmoi chdir` 切换到 chezmoi 源目录执行命令	中级	`chezmoi chdir -- git status`
`chezmoi cd` 快速跳转到 chezmoi 源目录	基础	`chezmoi cd`
`chezmoi git` 在源目录中直接运行 Git 命令	中级	`chezmoi git -- add . && chezmoi git -- commit -m 'Update'`
`chezmoi merge` 交互式合并源文件与目标文件之间的冲突	高级	`chezmoi merge ~/.bashrc`
`chezmoi unmanaged` 列出目标目录中不受 chezmoi 管理的文件	中级	`chezmoi unmanaged`
`chezmoi state` 查看 chezmoi 的持久化状态	中级	`chezmoi state dump`
`chezmoi data` 查看模板数据（计算结果）	中级	`chezmoi data`

模板引擎(4)

命令	难度	示例
`chezmoi template` 执行模板渲染测试	中级	`chezmoi template '{{ .chezmoi.os }}'`
`chezmoi dump` 查看模板渲染后的实际文件内容	中级	`chezmoi dump ~/.bashrc`
`.chezmoi.toml.tmpl` chezmoi 主配置文件（模板格式），定义模板变量	中级	`vim ~/.local/share/chezmoi/.chezmoi.toml.tmpl`
`.chezmoiexternal.toml` 配置外部文件来源（如从 GitHub 下载）	高级	`vim ~/.local/share/chezmoi/.chezmoiexternal.toml`

高级功能(3)

命令	难度	示例
`chezmoi import` 从存档文件中导入点文件	高级	`chezmoi import --tar archive.tar.gz`
`chezmoi secret` 管理和获取机密信息（支持 Bitwarden、pass、Keychain 等）	高级	`chezmoi secret bitwarden get item my-item`
`chezmoi agekey` 显示或生成 Age 加密密钥	高级	`chezmoi agekey`

常见问题

如何开始使用 chezmoi？

如何在 chezmoi 中使用模板？

chezmoi 如何管理机密？

本速查表数据整理自各工具官方文档。最后更新: 2026-07-20。