每次打开终端报错zsh: command not found 临时修复重启后失效如何解决

问题原因 #

PATH环境变量未持久化写入zsh启动配置文件，终端每次启动时未正确加载系统默认的命令搜索路径，导致所有基础命令无法识别。你使用的临时修复方案仅在当前终端会话生效，关闭终端后配置就会重置。

永久修复步骤 #

• 第一步：先执行临时修复命令，保证当前终端可以正常使用基础命令

  PATH=/bin:/usr/bin:/usr/local/bin:${PATH} export PATH
  

• 第二步：编辑当前用户的zsh配置文件~/.zshrc，以nano编辑器为例执行命令：

  nano ~/.zshrc
  

• 第三步：拉到配置文件最末尾，添加如下内容：

  export PATH="/bin:/usr/bin:/usr/local/bin:${PATH}"
  

  如果配置文件中已经存在export PATH开头的语句，先检查是否存在路径拼写错误、漏写系统默认路径的问题，直接修改原有行即可，无需重复添加
• 第四步：保存退出编辑器，nano操作逻辑为按Ctrl+O回车确认保存，再按Ctrl+X退出
• 第五步：手动加载配置验证是否生效：

  source ~/.zshrc
  

• 第六步：执行ls、pwd等基础命令验证功能正常，之后关闭终端重新打开也不会再出现报错。

特殊情况处理 #

如果修改用户级配置后问题仍然复现，说明全局zsh配置存在异常，需要编辑/etc/zshrc全局配置文件，编辑时需要加sudo权限：

sudo nano /etc/zshrc

同样在文件末尾添加上述的PATH导出语句，保存退出后执行source /etc/zshrc生效即可。

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