.zshrc与.zshrc.local的区别及.zshrc.local的加载时机

首先需要明确：.zshrc.local 并不是Z Shell官方原生设计的配置文件，它的存在是各类发行版、定制化生态为了降低配置维护成本做的通用约定，这也是你在Zsh官方文档里直接检索不到对应说明的核心原因。
两者的核心区别可以从定位和适用场景拆分：

• .zshrc 是Zsh官方定义的原生启动配置项，属于Shell启动流程内置识别的固定文件，默认存放在用户家目录下。所有对Shell本身的通用个性化定制（比如快捷键绑定、提示符样式、补全规则、Shell参数开关），默认都应该写在这个文件里，通常会配合dotfiles工具做多设备同步。
• .zshrc.local 是专门用来做配置分层的补充文件，本身没有强制的格式和加载规则，设计目的是把“通用配置”和“特定场景的专属配置”隔离开：
  • 通用配置：跨设备通用的个性化设置，写在.zshrc里同步
  • 专属配置：单台机器上才需要生效的内容，比如NixOS环境下nix-shell需要注入的Shell钩子、特定服务器上的专用环境变量、临时的Shell别名，就全部写在.zshrc.local里，避免多设备同步配置时把特定场景的无关内容带过去。

因为没有Zsh原生流程的内置定义，这个文件的加载时机完全取决于上游配置文件（通常是系统级或用户级的.zshrc）里主动写的加载代码，当前主流场景下的执行逻辑可以明确为两点：

• 通用Linux发行版（Debian、Ubuntu等默认zsh配置）的加载逻辑：会在用户/系统级.zshrc的末尾位置，内置一段自动检测代码——只要家目录下存在.zshrc.local，就会主动读取并执行这个文件里的所有内容。这种场景下它的执行时机是交互式非登录Shell启动流程的靠后阶段：先跑完.zshrc里所有的核心初始化逻辑，最后才执行.zshrc.local里的自定义内容，它里面写的配置可以覆盖之前已经设置过的环境变量、Shell选项。
• 你参考NixOS Wiki教程碰到的场景：NixOS会通过系统模块自动生成固定的系统级zsh配置文件，为了避免用户手动修改的内容在下次系统配置更新时被覆盖，官方会在系统级/etc/zshrc的末尾内置加载逻辑，自动读取用户家目录下的.zshrc.local文件。nix-shell相关的配置写在这里，既不会被系统生成的配置冲掉，又能在Shell启动时被正常执行。

常见认知误区：不少人以为.zshrc.local是比.zshrc加载更早的配置文件，实际上它一定是在.zshrc的加载流程走到末尾时才会被读取执行，不存在早于.zshrc生效的情况。

内容的提问来源于stack exchange，提问作者geckos