如何删除zsh启动时显示的"(not in PATH env variable)"提示？

这个提示是zsh初始化时执行的脚本在修改PATH环境变量时，出现无效路径或者语法错误导致的，可按以下步骤排查修复：

第一步：定位报错来源 #

• 执行调试命令zsh -l -x，该命令会输出zsh登录时执行的所有脚本内容，在输出内容中搜索not in PATH关键词，即可定位到触发报错的具体脚本行。
• 优先排查以下常见的zsh配置文件：
  • 用户级配置：~/.zshrc、~/.zshenv、~/.zprofile
  • 全局级配置：/etc/zshrc、/etc/zshenv
  • 若使用oh-my-zsh，额外排查~/.oh-my-zsh/custom/目录下的自定义插件、主题文件

第二步：修复常见错误 #

触发该提示的常见错误及对应修复方案如下：

• PATH拼接语法错误：最常见的是拼接路径时漏写冒号分隔符，比如错写为PATH=$PATH/opt/mybin，正确写法为PATH=$PATH:/opt/mybin；另外要注意赋值语句等号两侧不要加空格。
• 引用了未定义的路径变量：比如你写了PATH=$PATH:$GO_HOME/bin，但GO_HOME变量未提前定义，导致这段路径无效。修复时要么提前正确定义对应的变量，要么加路径存在判断，示例写法：

# 只有目录存在时才添加到PATH
[ -d "$GO_HOME/bin" ] && export PATH=$PATH:$GO_HOME/bin

• 第三方工具自动写入的配置错误：nvm、brew、conda等工具安装时会自动往zsh配置里写入PATH相关内容，如果这部分配置损坏，直接删除对应行后重新执行工具的环境初始化命令即可。

第三步：验证修复效果 #

修改完配置后执行source ~/.zshrc，或者新开一个终端窗口登录，确认提示不再出现即可。

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