---
title: chezmoi
url: https://doc.liz6.com/tools/chezmoi
locale: zh
area: tools
tags:
- tools
date: null
modified: 2026-06-30
description: 跨机同步 dotfiles —— 但重点是想清楚什么该进、什么不该进。
---

# chezmoi

[chezmoi](https://chezmoi.io) 把 dotfiles 收进一个 git 仓库,在每台机器上 `apply` 出去,还能按系统做模板差异。用法网上一大把,我这儿真正想说的是边界:**什么该交给它管,什么不该。**

我的标准是"自己手写、要多机一致"的才进。对应到现在,纳管的就是跨平台那几样:WezTerm 的 `~/.wezterm.lua`、Windows 上的 Neovim 配置、Windows 的 PowerShell profile 和 AutoHotKey。这几样我会两台机器来回改,一致性有价值。

反过来,Linux 桌面那一大坨——[Hyprland、Quickshell](hyprland/01-overview.md)、waybar——我没塞进来。一是体量大(光 Quickshell 就七万行),二是它跟着上游 rice 更新,我宁可"跟上游 + 本地改几处",也不想把别人的几万行 QML 纳进自己的 dotfiles 仓库当包袱。还有含密钥的东西也一律不进——那种该走环境变量或单独 gitignore,别让它进任何仓库历史。

留下的日常很简单:

```bash
chezmoi edit ~/.wezterm.lua    # 改源
chezmoi diff                   # 看 apply 会动什么
chezmoi apply                  # 落地
chezmoi cd && git commit -a && git push
```

新机器一句 `chezmoi init --apply <repo>` 拉下来铺好。

它的两块机制值得知道,够用就行:

**文件名前缀即属性**——chezmoi 不存元数据,把属性编码进源文件名:`dot_foo` → `~/.foo`、`private_` → 权限 600、`executable_` → 加可执行位、`readonly_`、`encrypted_`(配合 age/gpg 落地时解密)、`run_` 开头的脚本会在 apply 时执行(`run_once_` 只跑一次,适合装包/初始化)。看一眼文件名就知道它会变成什么。

**模板做按机差异**——`*.tmpl` 走 Go template,能读 `.chezmoi.os`、`.chezmoi.hostname` 这些内置变量和你自己在 `.chezmoidata` / config 里定义的值:

```gotmpl
{{ if eq .chezmoi.os "windows" }}
shell = "pwsh"
{{ else }}
shell = "zsh"
{{ end }}
```

同一份源,在 Windows 和 Linux apply 出不同结果——这正是我那几样跨平台配置(WezTerm、PowerShell、Windows 上的 Neovim)能共用一份的原因。`chezmoi diff` 在 apply 前永远先让我看清模板渲染后到底会写什么。

够用,不复杂——复杂的地方从来不在工具,在"克制别什么都往里塞"。