產品說明

Chezmoi 是一款專為開發者與系統管理員設計的 Dotfiles（設定檔）管理工具，用來解決「在多台電腦間同步環境設定」的痛點。與傳統「直接用 Git 備份 Home 目錄」的方式不同，Chezmoi 採用了更靈活的來源/目標（Source/Target）分離架構，讓你能輕鬆應對工作、個人、Linux 或 macOS 等不同環境的差異。

它以 Go 語言編寫，單一執行檔即可運作，無需依賴複雜的 Runtime。最強大的是它內建了密碼管理器整合與範本系統（Template System），讓你可以在公開的 GitHub Repo 中管理設定檔，卻又能安全地將 API Key 或私人 Token 注入到本地環境中，完美平衡了便利性與安全性。

核心特色：

多機環境差異化：透過 Go Template 語法，這份設定檔可以在公司電腦顯示 Email A，在家中電腦顯示 Email B。
安全性整合：原生支援 1Password、Bitwarden、KeepassXC 等密碼管理器，不再需要把密碼明文寫在設定檔中。
預覽與防呆：提供 diff 與 dry-run 模式，在覆蓋原本的設定檔之前，清楚告訴你將會發生什麼改變。
跨平台支援：無論是 Windows 的 PowerShell 設定，還是 Linux/macOS 的 Shell 設定，都能用同一個 Repo 統一管理。

常用指令

Chezmoi 的指令設計非常直覺，許多指令與 Git 類似，上手門檻極低。以下是日常最核心的操作指令：

基礎操作與範例

# 範例 1：初始化並套用設定
# 在新電腦上，只需一行指令即可下載你的 Dotfiles Repo 並完成環境建置
chezmoi init --apply <你的GitHub帳號>

# 範例 2：納管新的設定檔
# 將原本散落在 ~/.bashrc 的檔案加入 Chezmoi 管理
chezmoi add ~/.bashrc

# 範例 3：編輯設定檔
# 這會開啟你預設的編輯器修改 Source 區的檔案，修改後會自動檢查語法
chezmoi edit ~/.bashrc

# 範例 4：套用變更
# 編輯完成後，將 Source 的變更實際寫入到 Home 目錄
chezmoi apply

# 範例 5：同步遠端更新
# 從 GitHub 拉取最新的設定，並套用到這台電腦
chezmoi update

參數/指令	功能說明	對應操作
init	初始化	設定一個新的 Repo 或從遠端下載現有 Repo
add	新增納管	將現有的本地檔案加入到 Chezmoi 管理清單
edit	編輯檔案	編輯 Source 目錄中的檔案 (支援自動 Reload)
apply	套用變更	將 Source 的狀態同步到實際的 Home 目錄
diff	比對差異	顯示 Source 與實際檔案之間的差異
cd	切換目錄	進入 Chezmoi 的 Source 目錄 (通常也是 Git Repo)

Chezmoi

產品說明

常用指令

基礎操作與範例

操作介面