为什么zsh环境下无法执行npm脚本，bash终端却可正常运行？

问题原因 #

报错Error: spawn brave ENOENT是React开发服务启动时尝试自动调用你配置的默认浏览器brave，但zsh运行环境中找不到该浏览器的可执行文件导致的。
bash可以正常运行的核心原因是两个shell的环境变量加载逻辑不同：要么是bash中没有设置BROWSER环境变量会自动调用系统默认浏览器，要么是bash的PATH变量包含了brave的安装路径，或者bash中配置的BROWSER值为正确的可执行文件路径。

解决方案 #

• 临时测试：在zsh终端的项目目录下执行BROWSER=none npm start，启动服务时不会自动打开浏览器，手动访问控制台输出的本地地址即可使用，可先验证服务本身是否正常。
• 修复zsh全局环境变量：编辑zsh配置文件~/.zshrc，找到BROWSER相关配置行：
  • 若不需要指定brave为默认浏览器，直接删除该行配置，执行source ~/.zshrc生效后，会自动调用系统默认浏览器
  • 若要保留brave为默认浏览器，将BROWSER的值修改为brave的绝对可执行路径，例如Mac端为/Applications/Brave Browser.app/Contents/MacOS/Brave Browser，Linux端通常为/usr/bin/brave-browser，Windows端通常为C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe，修改后执行source ~/.zshrc生效
• 项目级固定配置：在React项目根目录新建.env文件，添加配置行BROWSER=none，即可让该项目所有shell环境启动时都不自动打开浏览器，也可填写指定浏览器的绝对路径实现固定调用。
• 修复PATH变量：如果需要在zsh全局环境中识别brave命令，可在~/.zshrc中添加export PATH="$PATH:brave的安装目录绝对路径"，执行source ~/.zshrc后生效。

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