WebStorm运行配置无法读取.zshrc导出的NPM_TOKEN环境变量

问题原因 #

WebStorm默认使用bash作为系统shell，因此无法读取你在.zshrc中配置的环境变量（比如NPM_TOKEN），导致NPM运行配置、Git提交等操作报错。而终端（包括WebStorm内置终端）是直接启动zsh，所以能正常加载变量。

配置步骤 #

1. 设置WebStorm默认使用zsh作为登录shell #

• 打开WebStorm设置（快捷键：Ctrl+Alt+S / Cmd+,）
• 进入Tools > Terminal选项
• 在Shell path中填入zsh的实际路径，可通过终端执行which zsh获取（通常是/bin/zsh或/usr/bin/zsh）
• 勾选Run command as login shell，确保zsh加载登录shell配置文件（如.zprofile、.zshrc）

2. 让NPM运行配置读取zsh环境变量 #

• 打开运行配置（右上角运行按钮下拉框 → Edit Configurations）
• 选中对应的NPM配置（比如start）
• 在Environment variables区域：
  • 勾选Include system environment variables，让配置继承zsh加载的系统环境变量
  • 若仍有问题，可手动添加NPM_TOKEN=你的token（不推荐，优先通过shell自动加载）

3. 修复Git提交时的环境变量问题 #

• 进入WebStorm设置的Version Control > Git
• 确保Git使用的shell是zsh：
  • 部分版本可直接在该页面设置Shell path为zsh路径
  • 或者在终端执行全局Git配置：

    git config --global core.shell /bin/zsh
    

4. 验证配置 #

• 重启WebStorm，打开内置终端确认当前shell为zsh（查看提示符）
• 运行NPM的start命令，检查是否仍有Failed to replace env in config: ${NPM_TOKEN}错误
• 尝试Git提交操作，确认正常执行

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