企业官网建设流程全解析

mise Dotfiles 管理全指南：版本追踪、跨机同步与声明式配置实战

【免费下载链接】misedev tools, env vars, task runner项目地址: https://gitcode.com/GitHub_Trending/mi/mise

本篇指南围绕 mise 的 dotfiles 功能展开：它既能像版本管理工具一样在后台保存~/.zshrc、~/.gitconfig等配置文件的修改历史，也能把配置源文件以软链接、复制或模板渲染的方式"落位"到应用实际读取的路径，还支持跨机器双向同步。读完本文，你将掌握mise bootstrap dotfiles的完整命令体系、[dotfiles]配置表的全部字段与模式语义，并能独立搭建一套"配置自己管理自己"的 dotfiles 工作流。文中所有命令与配置均来自当前仓库 docs/dotfiles.md，并结合 src/cli/dotfiles/mod.rs 与 src/system/files.rs 的源码实现加以印证。

什么是 mise 的 dotfiles

Dotfiles 指~/.zshrc、~/.gitconfig这类散落在用户目录中的配置文件。mise 对它们提供两条互补的路径：

• 原地追踪（tracking in place）：文件留在原处，mise 在后台保存每个版本的快照（checkpoint），你随时可以回滚到之前的版本；开启同步后，笔记本上的编辑会推送到台式机，台式机的编辑也会回流。
• 声明式管理（managed files）：你维护一份源文件（source），mise 按配置把内容以软链接、复制或模板渲染的方式写到目标路径（target），即应用实际读取配置的位置。

初次尝试时，可以从"追踪一个你正在使用的文件"开始；如果希望 mise 替你复制或链接文件，则从"一个受管文件"开始。两者的历史与同步能力都建立在同一个 Git 历史机制之上，详见 docs/history.md。

快速上手：原地追踪配置文件

追踪一个现有文件

假设你使用 zsh，想为~/.zshrc开启历史保护：

mise bootstrap dotfiles track ~/.zshrc

mise 不会移动这个文件，只会保存一个checkpoint（一个可供你随时查看或恢复的版本），同时向全局配置（默认是~/.config/mise/config.toml）写入如下条目：

[dotfiles] "~/.zshrc" = { mode = "track" }

track是六种文件模式之一。从源码看，FileMode枚举完整定义了symlink、symlink-each、copy、template、content与track六种模式（见 src/system/files.rs），track的含义是"现场文件留在原地，由历史机制保护并共享它"。

自动保存编辑

想要"改了自动存"，在同一个全局配置文件里启用 watcher 服务：

[bootstrap.services.mise-history] builtin = "history-watch"

然后安装并启动它，再检查运行状态：

mise bootstrap services apply mise bootstrap dotfiles status

status会把文件显示为tracked，并标明 watcher 正在运行。此后正常编辑即可，watcher 会把改动自动保存进本地 Git 历史。服务细节见 自动保存。

不想常驻服务时，可以手动保存——每次编辑后执行：

mise bootstrap dotfiles save ~/.zshrc

试一次回滚

在编辑器里给~/.zshrc加一个别名：

alias ll='ls -lah'

手动保存一个 checkpoint（不用等 watcher），然后查看该文件的历史：

mise bootstrap dotfiles save ~/.zshrc mise bootstrap dotfiles history --path ~/.zshrc

如果这是你唯一的改动，回滚就会删掉这个新别名。先预览再执行：

mise bootstrap dotfiles rollback ~/.zshrc --dry-run mise bootstrap dotfiles rollback ~/.zshrc

回滚会恢复"与当前文件内容不同"的最新已保存版本，并在恢复前先保存当前内容——因此你可以用mise bootstrap dotfiles undo撤销这次回滚。若要精确选择某个 checkpoint，见 docs/history.md。

跨机器共享

历史默认只存在本地 Git 仓库里，直到你配置一个远程仓库（origin）。连接自己的仓库并开启自动同步后，保存的编辑就会双向流转。注意 watcher 需要在每台机器上都具备 Git 凭证。接入仓库的具体步骤见 跨机器共享，把配置带到新电脑则参考 docs/bootstrap/setup.md。

有两个安全前提务必遵守：

• 使用私有仓库：同步会连更早的 checkpoint 一并发送，临时编辑也可能进入共享历史。
• 加密先行：对有敏感内容的文件，在首次保存前就配置好加密共享文件。

从零管理一个文件：source 与 target

mise 也能从你维护的源文件生成配置文件。先创建dotfiles/example.conf（放在mise.toml旁边），内容如下：

enabled = true

再向mise.toml添加条目（示例中请选择一个未占用的目标路径）：

[dotfiles] "~/.config/mise-dotfiles-example.conf" = { source = "dotfiles/example.conf", mode = "copy" }

预览、应用并确认结果：

mise bootstrap dotfiles apply --dry-run mise bootstrap dotfiles apply mise bootstrap dotfiles status

此时目标文件里应包含enabled = true，status将其报告为applied。以后修改源文件后再次执行apply即可。

[!WARNING] 在copy模式下，apply 会覆盖你对目标文件的直接修改。请在再次 apply 之前，用add把这些修改保存回源文件。

如果从一个已存在的文件起步，运行mise bootstrap dotfiles add <target>。它会：

1. 把文件保存到dotfiles.root（默认~/.dotfiles）下；
2. 写入对应的配置条目；
3. 用dotfiles.default_mode应用它——该设置默认是symlink，即把原路径变成指向已保存源文件的链接。

--mode可切换模式，例如--mode copy在目标位置保留常规文件；--no-apply则只生成源文件与配置，不触碰原文件，方便你先审查再落地。

apply也是mise bootstrap的一部分，会执行配置的pre-dotfiles与post-dotfiles钩子。而mise install与mise bootstrap packages不会碰 dotfiles。若也想为这种方式管理的源/目标保存历史，请再对它执行一次原地追踪。

模式（Modes）

mode决定 mise 如何从源创建目标，完整语义如下：

例如链接整个目录：

[dotfiles] "~/.config/nvim" = { source = "dotfiles/nvim", mode = "symlink" }

symlink-each要求源必须是目录。当某个源文件被删除或被排除时，下一次 apply 会移除对应的链接，目标目录里的其他文件保持不变。mise 把这些链接记录在$MISE_STATE_DIR/dotfiles下，务必保留该目录，后续 apply 才能正确更新或移除之前创建的链接。

目录复制则是增量的：删除或排除源文件后，目标里已有的文件会保留，需要你自行检查并清理遗留副本。

模板

[dotfiles] "~/.gitconfig" = { source = "dotfiles/gitconfig.tera", mode = "template" }

模板可以使用env、vars、exec()以及模板上下文中的其余能力。apply 会写入渲染结果，并赋予目标文件与源文件相同的权限；后续 apply 还会修复被改动的权限。

status、diff与apply在检查输出时会实际渲染模板——也就是说模板里的exec()会被执行，请确保配置是可信的。--dry-run模式下 mise 跳过模板渲染并标注为(if changed)，但其他配置表达式仍可能运行，因此 dry-run 也应在可信配置下使用。

Windows 上链接行为的差异见下文专门小节。

整文件条目（Whole-file entries）

[dotfiles]中每个条目以目标路径为键，值可以是字符串或表。键支持绝对路径或以~/开头的路径；源可以是文件或目录。

推断源路径

省略source时，mise 在dotfiles.root（默认~/.dotfiles）下按"相对家目录的同一路径"查找：~/.zshrc对应的源是~/.dotfiles/.zshrc，~/.config/foo.toml对应~/.dotfiles/.config/foo.toml。家目录之外的目标必须显式给出source或内联content。源码中的implied_source正是先把目标路径剥掉$HOME前缀，再拼接到dotfiles_root()上（见 src/system/files.rs）。

[dotfiles] "~/.zshrc" = { mode = "symlink" } "~/.ssh/config" = { source = "ssh/config", mode = "copy" }

上例分别演示了推断源与显式源。相对source路径以声明它的配置文件所在目录为基准：~/.config/mise/config.toml里的source = "ssh/config"指向~/.config/mise/ssh/config。

source也可以直接写成字符串，例如"~/.config/nvim" = "dotfiles/nvim"，此时使用dotfiles.default_mode。add写入条目时：能推断出源就省略source，默认的symlink模式也省略；只有用--mode显式选择的模式才会被明确写入。这些行为与 src/system/files.rs 中FileTomlEntry的字段解析逻辑一致——mode在 TOML 层保持字符串，遇到未来版本的未知模式会告警并跳过，而不是解析失败。

内联内容（content）

content直接在配置里声明一个完整文件，无需单独的源文件。Unix 下生成的文件权限为0600，只有属主可读写：

[dotfiles] "~/.config/example.conf" = { content = "enabled = true\n" }

content必须单独使用，不能与source、mode、exclude、manifest或编辑选项block、line、template、comment组合。

用通配符匹配多个源文件

源路径可以包含 glob 通配符*、**、?、[ab]。当通配符源匹配到多个路径时，目标路径也必须包含对应通配符，才能把每个源展开成唯一的目标：

[dotfiles] "~/.config/*.toml" = "dotfiles/config/*.toml" "~/.local/share/app/**/*.json" = { source = "dotfiles/app/**/*.json", mode = "copy" } "~/.config/app?.toml" = "dotfiles/config/app?.toml" "~/.config/theme-[ab].toml" = "dotfiles/config/theme-[ab].toml"

排除文件（exclude）

遍历源目录的模式——symlink-each与目录源的copy——支持excludeglob 列表。当你需要指向一个并不完全"归你所有"的目录（例如放着mise.toml本身的目录）时，这是标准做法：

[dotfiles] "~" = { source = ".", mode = "symlink-each", exclude = ["mise.toml", "*.md", ".git"] }

排除规则的匹配语义：

• 不含/的模式匹配任意单个路径组件："mise.toml"会跳过树中任何位置的该文件，"*.md"跳过所有 markdown 文件；
• 含/的模式锚定到源根："nvim/spell"只跳过这一条路径；
• 任一规则匹配到目录时，该目录下的所有内容一并跳过。

对symlink-each，排除一个曾受管文件会在下次 apply 时移除其记录链接（与删除源等价）；对目录copy则是纯增量的：排除只阻止未来的复制，已存在的目标文件不动。

Git 清单（manifest = "git"）

在目录遍历条目上设置manifest = "git"，可以只管理 Git 索引中的文件。这对使用gitignore *加git add -f显式纳入文件的仓库特别有用，无需在 mise 里把每个路径再列一遍：

[dotfiles] "~" = { source = ".", mode = "symlink-each", manifest = "git" }

mise 从源目录执行git ls-files。被忽略与未跟踪的文件保持原样；把文件移出索引后，下一次 apply 会移除 mise 拥有的symlink-each链接。exclude可与 Git 清单组合，作为额外过滤器。Git 清单要求目录源，并且模式必须是symlink-each或copy。

当不同环境配置为同一目标选择了不同的symlink-each源时，切换到新环境会在 apply 时**对账（reconcile）**之前源记录下来的链接。这让mise bootstrap -E home与mise bootstrap -E work可以当作配置文件档案（profile）切换：旧档案独有的链接被移除，共享路径重新指向，未受管邻居保持不变。

编辑条目（Edit entries）

编辑条目管理文件中的一小段：shell rc 里的mise activate块、/etc/hosts中的一行、或某个配置文件里的小片段。它以"目标路径 + 该文件内每个编辑的 id"作为键：

[dotfiles] "~/.zshrc/activate" = { block = 'eval "$(mise activate zsh)"' } "~/.zshrc/aliases" = { block = ''' alias ll='ls -l' alias la='ls -la' ''' } "/etc/hosts/dev" = { line = "127.0.0.1 dev.local" } "/etc/zshrc/zdotdir" = { line = 'ZDOTDIR=$HOME/.config/zsh/', position = "prepend" } "~/.gitconfig/identity" = { source = "snippets/git-identity.tmpl", template = "tera" }

对编辑条目，source必须与template = "tera"配对，以明确这是一个编辑条目；只有source的表会被当作使用dotfiles.default_mode的整文件条目。

block：带标记的块

block由目标文件中的标记注释界定，标记以条目 id 命名：

# >>> mise:activate >>> managed by mise - do not edit between markers eval "$(mise activate zsh)" # <<< mise:activate <<<

apply 会替换标记之间的内容；若块不存在则追加。文件里其他内容一概不动。

id 可包含字母、数字、_、-和.。标记注释的前缀根据文件扩展名推断（shell/配置文件用#，Lua 用--，类 C 语言用//，INI 用;，vim 用"），也可以用comment = "..."覆盖。无法容纳行注释的文件（严格 JSON、XML）不适合 block——请改用整文件条目。

line：单行插入

line在目标缺少这一行精确文本时插入。默认追加到文件末尾，position = "prepend"则插入到开头。再次 apply 时，已存在的匹配行保持原位。文件的其他字节（包括行尾符）保持不变。值必须是单行；多行内容请用 block。

配置如何被应用（语义）

• 条目跨配置层级合并：整文件条目按目标路径合并，编辑条目按(path, id)合并。追踪（track）只使用 system 与 global 配置。
• mise bootstrap dotfiles add会应用它捕获的条目（除非传入--no-apply）；其余条目用mise bootstrap dotfiles apply或mise bootstrap应用。
• apply 会跳过已经匹配的目标。模板在检查输出时仍可能被执行。copy 与 template 条目会覆盖被改动的目标。
• mise 对未知模式或未知操作给出告警并跳过——对应源码中FileMode::parse对无法识别字符串返回None的分支（src/system/files.rs），以及"告警并跳过"的配置合并逻辑（src/system/files.rs）。

冲突处理（Conflicts）

对symlink条目，mise 拒绝替换冲突的既有路径：本应放软链接的位置已有真实文件/目录，或本应放文件的位置已有目录，都会报错并列出冲突路径。使用mise bootstrap dotfiles apply --force强制替换。

需要特别注意的是：即使目标内容与权限和源完全一致，用软链接替换真实文件或目录仍然要求--force。要"收养"一个现有文件，正确做法是mise bootstrap dotfiles add——它会先把文件移动到源路径，再创建链接；当源位于另一文件系统时，mise 会复制它并保留符号链接与权限。

copy与template条目无需--force就会覆盖目标内容，已存在的软链接也可以被重新指向。在更换目标使用的源之前，先用diff检查差异。

block 与 line 无需--force即可应用。若块的标记已损坏、或编辑目标是软链接，mise 会报错；对软链接，请把编辑指向你想修改的真实文件。

从配置中删除条目不会删除对应文件、块或行。想一并移除它们，先运行mise bootstrap dotfiles unapply，再删除配置条目。

撤销应用（Unapplying）

mise bootstrap dotfiles unapply只移除配置的目标，不删除[dotfiles]条目与源文件。它结合当前配置、文件系统状态与记录的symlink-each状态来判断条目拥有什么：

• symlink目标仅在仍指向配置源时被移除；
• symlink-each移除精确的源到目标链接，包括源文件已删除造成的悬空链接；目标下的其他链接与文件保留；
• 文件复制与模板渲染产物仅在内容仍匹配时移除，被修改的目标需要--force；
• 目录复制逐文件移除；未受管邻居总是保留，目录仅在为空时删除；
• 标记界定的 block 连同标记一起移除；普通 line 编辑没有归属标记，需要--force。

如果已从复制的目录中删除了源文件，unapply 无法识别它的旧副本，请自行清理。先--dry-run预览移除内容。模板的 dry-run 会跳过渲染与模板函数调用。

命令参考

mise bootstrap dotfiles status # 显示受追踪文件与受管文件的状态 mise bootstrap dotfiles status --missing # 任何项不同步则退出码为 1 mise bootstrap dotfiles diff # 显示应用所需的改动 mise bootstrap dotfiles diff ~/.zshrc # 只显示单个目标的改动 mise bootstrap dotfiles apply # 应用文件与编辑 mise bootstrap dotfiles apply --dry-run # 打印将要执行的操作 mise bootstrap dotfiles apply --dry-run --verbose # 附带类似 diff 的细节 mise bootstrap dotfiles apply --yes # 跳过确认提示 mise bootstrap dotfiles apply --force # 同时替换冲突文件 mise bootstrap dotfiles unapply # 移除可识别的受管目标 mise bootstrap dotfiles unapply --dry-run # 预览移除 mise bootstrap dotfiles unapply --force # 同时移除被修改/有歧义的目标 mise bootstrap dotfiles track ~/.zshrc # 原地追踪现有文件 mise bootstrap dotfiles untrack ~/.zshrc # 停止追踪，文件保留 mise bootstrap dotfiles add ~/.zshrc # 把现有文件收纳进 dotfiles.root mise bootstrap dotfiles add --changed # 收纳所有被修改的 copy 模式文件 mise bootstrap dotfiles edit ~/.zshrc # 编辑受管源或所属配置 mise bootstrap dotfiles edit --apply ~/.zshrc mise bootstrap dotfiles save # 立即为受追踪文件存档 mise bootstrap dotfiles history # 浏览 checkpoint；含 history show、history diff mise bootstrap dotfiles paths # 列出受追踪路径及其保存设置

status 输出解读

mise bootstrap dotfiles status将每个条目报告为tracked、applied、missing、differs（附原因）或source missing，随后是历史状态：追踪了什么、最新 checkpoint、未完成操作、以及是否自动保存编辑。

status --missing适合在脚本中使用：只要任一选中条目不同步就以状态码 1 退出，显示的列表与status相同。

历史记录联动

每次apply、add、unapply与edit --apply都会记录一对历史 checkpoint——改动前后受追踪文件的状态，同时记录本次操作触碰了哪些路径。mise bootstrap dotfiles history可浏览这些 checkpoint。

JSON 输出

mise bootstrap dotfiles status --json用source_missing表示source missing状态。每个条目还包含origin对象，描述配置来源：配置文件、其config_root、配置文件名中的 mise 环境、以及解析后的源路径。

路径在 UTF-8 有效时输出为字符串。Unix 上包含非 UTF-8 字节的路径使用mise:path-bytes:<base64url>表示。

捕获修改（Capturing changes）

在 copy 模式下直接编辑了 dotfile、想把改动存回 dotfiles 时，再次运行add：

$EDITOR ~/.config/starship.toml mise bootstrap dotfiles add ~/.config/starship.toml

mise bootstrap dotfiles add --changed会更新所有以copy模式管理、且内容已变化的常规文件的源。每个被选中文件的配置必须是可信的；该命令跳过目录复制、软链接、模板与内联内容。

对未受管目标，add会创建[dotfiles]条目并在dotfiles.root下播种源；对已受管目标，则用现场文件更新既有源。

追踪选项（Tracking options）

保存与加密策略

手动保存的文件示例：

mise bootstrap dotfiles track ~/.config/app/state.json --no-autosave mise bootstrap dotfiles save ~/.config/app/state.json

第一条命令保存初始版本，之后的编辑要等显式save。修改受追踪文件的命令如何保存前后版本，见 docs/history.md。

保存与共享是两套独立设置：使用手动同步时，mise 仍会在本地持续提交；你的下一次 push 会把积累的所有提交发给 origin。共享作用于整个历史；想把某个文件排除在共享之外，就保持它不被追踪。取消追踪或排除文件不会删除历史上已提交的版本。

文件、目录与符号链接

可以追踪家目录或 mise 配置目录下的精确文件/目录路径。glob 模式由历史排除规则支持，但不能直接作为追踪条目。追踪目录会包含其后新增的文件（受排除规则约束）。

建议从单个配置文件开始，以便精确选择要保存的内容。日志、缓存、数据库与应用会话状态不要纳入历史。凭证文件与*.local.toml文件默认被排除；需要保存凭证时见加密追踪。

追踪软链接保存的是链接本身；要保存其指向的内容，请分别追踪目标。若父目录是软链接，追踪该链接，并用真实目录路径追踪其下的文件。家目录与 mise 配置目录本身可以是软链接——共享历史时 mise 会把这两个根映射到每台机器对应的目录。

为每个要保存的文件或目录添加显式追踪条目，包括 mise 配置目录或dotfiles.root。追踪条目不能包含source、content、exclude或manifest；mise bootstrap dotfiles paths会把这类非法组合报告出来并排除在历史之外。track命令在写入的条目未生效时以非零码退出。

停止追踪

mise bootstrap dotfiles untrack ~/.zshrc

文件保留原位，早先的 checkpoint 仍留在 Git 里，只是此后不再产生新 checkpoint。

变体（variants）：不同机器不同内容

变体让同一个受追踪路径在不同机器上拥有不同内容。例如为 macOS 与 Linux 分别维护~/.zshrc：

[dotfiles] "~/.zshrc" = { mode = "track", variants = [{ os = "macos" }, { os = "linux" }] }

把它加入全局配置，或用mise bootstrap dotfiles track ~/.zshrc --os macos添加一个变体。os选择器接受可选的/arch（与 bootstrap packages 一致）。用profile选择 mise 环境：

[dotfiles] "~/.gitconfig-work" = { mode = "track", variants = [{ profile = "work" }, { default = true }] }

当多个变体同时匹配时，mise 为每个打分：profile得 2 分，os得 1 分，架构再加 1 分，最高分胜出。因此"仅 profile"的变体会与"os + 架构"的变体打成平手。最高分并列时，mise 报告歧义并跳过该路径，直到你修复它。

没有任何变体匹配时，使用标记default = true的变体；没有默认变体则在该机器上跳过保存与应用。其他机器保存的版本仍保留在 checkpoint 中。

追踪 mise 同时管理的文件

你可以为 mise 复制、链接、模板化或编辑的文件保存历史。例如追踪~/.zshrc也会保存受管 activate 块或mise bootstrap mise-shell-activate产生的改动。

追踪一个已受管文件时，mise 保留其原有条目，并把追踪条目写入conf.d/dotfiles-tracking.toml；untrack 只移除该追踪条目。受追踪目录可以包含受管文件或模板源，它们的复制/链接/模板设置继续生效。试图创建同一目标的冲突条目仍会被拒绝。

追踪条目属于 system 或 global 配置；mise 会告警并忽略项目配置中的mode = "track"。要关闭从其他配置文件继承的条目，在更靠后的配置层设enabled = false；untrack对 system 条目做的正是这件事。源码中enabled字段与override_from的继承语义见 src/system/files.rs。

自管理 mise 配置

你可以把 mise 配置与 dotfiles 根目录本身也当作 dotfiles 来管理：

[settings] dotfiles.root = "~/.dotfiles" [dotfiles] "~/.dotfiles" = "~/src/dotfiles" "~/.config/mise/config.toml" = "~/src/dotfiles/mise/config.toml"

这是一个典型的 bootstrap 模式：在第一次mise bootstrap dotfiles apply或mise bootstrap之前，先克隆真实仓库（例如~/src/dotfiles）。首次运行所需的源请使用真实仓库路径——~/.dotfiles要等 mise 创建软链接之后才存在。替换~/.config/mise/config.toml会影响后续所有 mise 调用，所以 apply 之前务必确认源里是合法配置。

root 属主文件

dotfiles 以当前用户身份写入，没有 sudo。以 root 运行（容器、CI）时管理/etc/hosts没有问题；否则 mise 只会报一个普通的权限错误。

Windows 平台差异

symlink在 Windows 上可行时会创建真正的文件符号链接。Windows 在开启开发者模式（Developer Mode）后无需提权即可创建符号链接——这与windows_shim_mode的symlink选项依赖同一权限——权限不可用时 mise 退化为复制文件，因此条目总能应用。mise bootstrap dotfiles status会读取磁盘上实际存在的形式。

symlink-each在 Windows 上仍然复制文件；目录符号链接使用 junction。

命令兼容性

[!WARNING] 顶层mise dotfiles命令已废弃并从帮助中隐藏。它将在 mise 2027.2.0 开始告警、2028.2.0 被移除。请改用mise bootstrap dotfiles。

这一弃用与源码一一对应：src/cli/dotfiles/mod.rs中的旧Dotfiles命令携带deprecated_at!宏（2027.2.0 起告警、2028.2.0 移除），且所有子命令都标记为隐藏（见 src/cli/dotfiles/mod.rs）；新命令体系则在mise bootstrap dotfiles下完整展开。

深入源码

mise bootstrap dotfiles的命令族集中在src/cli/dotfiles/目录：add、apply、diff、edit、rollback、save、status、sync、track、unapply、untrack、undo、watch等子命令各自独立成文件，模块入口src/cli/dotfiles/mod.rs还提供了一个值得注意的细节：如果某个配置文件中声明了[dotfiles]但该文件因不受信任被跳过，mise 会主动告警（"[dotfiles]in these config files was skipped because they are not trusted"），提示你先在该目录运行mise trust——避免"明明配置了却什么都没发生"的困惑。

底层实现上，src/system/files.rs 是整文件条目的核心：FileMode定义六种模式，FileTomlEntry负责 TOML 解析（兼容字符串简写与表两种写法），FilePolicy承载autosave/encrypt策略并记录哪些字段是显式声明的以便跨配置层继承，FileState枚举对应status输出的applied/missing/differs/source missing/tracked状态。编辑条目（block/line）则由src/system/edits.rs实现。理解这些模块的组织方式，有助于在排查 dotfiles 行为时快速定位到对应的解析、应用与状态判断逻辑。

至此，从"追踪一个文件开始记录历史"到"用模板渲染生成机器专属配置"，再到"私有仓库双向同步、变体按平台分流"，你已经掌握了 mise dotfiles 的全部主干能力。建议按本文顺序走一遍"追踪 → 回滚 → 共享 → 声明式管理"的完整链路，再逐步引入symlink-each、模板与编辑条目等高阶特性。

【免费下载链接】misedev tools, env vars, task runner项目地址: https://gitcode.com/GitHub_Trending/mi/mise