zsh中使用通配符批量source文件时出现中断如何调试排查？

首先需要注意：source 命令一次只能加载一个脚本文件，你直接写 source $SNIPPETS/*.zsh 的写法本身就有问题：shell 展开通配符后，只会把第一个匹配到的 .zsh 文件作为加载对象，后续所有文件都会被当做传入第一个脚本的位置参数，根本不会被执行，这是绝大多数类似问题的根因。

以下是完整的排查及修复步骤：

1. 修正批量 source 的基础写法 #

把你 .zshrc 里的对应行替换为循环写法，保证每个文件都被单独 source：

for zsh_file in "${SNIPPETS:?}"/*.zsh(N); do
  source "$zsh_file"
done

其中 ${SNIPPETS:?} 的作用是当 $SNIPPETS 变量未定义时直接报错，避免错误匹配到根目录下的 .zsh 文件；末尾的 (N) 是 zsh 的通配符修饰符，当目录下没有匹配的 .zsh 文件时不会抛出通配符不匹配的错误。

2. 排查加载过程中的中断问题 #

如果修改为循环写法后还是有部分文件未加载，说明加载过程中存在异常中断，可以在循环中添加调试日志定位问题文件：

for zsh_file in "${SNIPPETS:?}"/*.zsh(N); do
  echo "正在加载: $zsh_file" >&2
  source "$zsh_file"
  echo "加载完成: $zsh_file" >&2
done

重新加载 .zshrc 或者重启终端后，观察终端输出：如果某一行只打印了「正在加载」没有对应「加载完成」，说明该文件就是导致流程中断的问题文件。

3. 定位单个文件的异常原因 #

找到问题文件后，单独执行 source 问题文件路径 观察报错信息，重点检查以下内容：

• 文件内是否存在未放在函数/条件判断内的裸 return、exit 语句，执行到这类语句会直接终止当前 shell 上下文，中断后续加载
• 你的 .zshrc 是否开启了 set -e（命令执行失败即退出）、set -u（使用未定义变量即报错）这类严格选项，问题文件内如果存在执行失败的命令、未定义的变量，就会触发中断
• 文件是否存在语法错误：比如括号、引号不闭合，错误的关键字拼写，source 时会直接抛出语法错误终止执行
• 文件是否有读权限：执行 ls -l 问题文件路径 确认当前用户对该文件有可读权限

4. 增加容错逻辑避免单文件故障影响全局 #

排查修复完问题后，可以给循环增加容错处理，后续单个文件出现异常不会中断所有后续文件的加载：

for zsh_file in "${SNIPPETS:?}"/*.zsh(N); do
  source "$zsh_file" || echo "加载失败: $zsh_file" >&2
done

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