WebStorm 配置外置工具需谨慎：仅当 npm scripts 不足时才用，Program 填绝对路径，Working Directory 用 $ProjectFileDir$，避免 PATH 问题；不支持调试，输出可重定向至日志文件。
WebStorm 里配外置工具跑脚本，不是为了炫技，而是当 npm scripts 不够用、或者你想把某个 shell 命令/Python 脚本/自定义构建步骤一键触发时，才值得配——配错路径或工作目录，命令根本不会执行，连错误都不报。
怎么添加一个能真正执行的 External Tool
别从“External Tools”菜单瞎点，先确认你真需要它：npm 脚本能干的事（比如 dev、build），优先用 WebStorm 自带的 npm 工具窗口；只有像 git clean -fdx、find . -name "*.log" -delete 这类纯系统命令，或调用项目外的 Python/Shell 脚本，才走 External Tool。
-
Program必须填绝对路径：Windows 上是C:\Users\name\AppData\Roaming\npm\pnpm.cmd，macOS/Linux 是/opt/homebrew/bin/pnpm或which pnpm输出的结果；别写pnpm—— WebStorm 不走 shell PATH 查找 -
Working Directory推荐用$ProjectFileDir$，不是$FileDir$：前者始终是项目根，后者会随你右键的文件位置变，容易在子目录里执行失败 -
Parameters里别硬编码路径，用$FilePath$或$SelectedText$这类宏，比如传当前打开的 JS 文件给 ESLint：--fix $FilePath$
为什么点了“Run”没反应，或报 “Command not found”
最常见原因是 WebStorm 没继承你的 shell 环境变量，尤其是 PATH。它启动时只读系统级 PATH，不加载 ~/.zshrc 或 ~/.bash_profile 里的 export。
- macOS/Linux：在
Program里不要直接填node，改用/usr/bin/env node（前提是你的 shell 环境里node可用） - Windows：如果用了 WSL 的 Node.js，别指望 Windows 下的 WebStorm 能直接调用
wsl node—— 得配成C:\Windows\System32\wsl.exe，Parameters填-e node -v，再手动设Working Directory为 WSL 路径（如/home/user/myproject） - 所有平台：检查右下角状态栏是否显示 Node.js 版本；没显示说明 WebStorm 根本没识别到运行时，External Tool 更不可能跑起来
如何让 External Tool 支持调试或带输出日志
External Tool 本质是黑盒执行，不支持断点、变量监视；但它可以输出到 Run 工具窗口，方便查错。
- 默认就在 Run 窗口输出，但如果你勾了
In terminal，它就会新开终端窗口执行——这反而难定位问题，因为输出不进 WebStorm 日志索引，也点不了错误行跳转 - 想看详细日志，
Parameters末尾加2>&1 | tee /tmp/external-tool.log（macOS/Linux），Windows 可用2>&1 | Out-File -FilePath C:\temp\log.txt - 需要调试逻辑？别硬扛——把脚本逻辑拆出来，用
Node.js运行配置跑，它支持 attach、断点、console.log高亮，External Tool 只负责触发
真正麻烦的从来不是配完能不能跑，而是配完之后你忘了它依赖某个环境变量、某条 PATH、甚至某个已卸载的 CLI 工具——下次换电脑或重装系统，整个 External Tool 列表全废。建议把关键配置截图存档，或干脆写个 .webstorm-external-tools.md 记录每个 tool 的 Program 来源和必要前置条件。
