webstorm中ng命令报“command not found”是因为未加载系统node.js全局bin路径；mac/linux需配置terminal为login shell（如/bin/zsh -l），windows需检查path或勾选use login shell，并手动指定angular cli路径。
WebStorm 里 ng 命令报 “command not found” 怎么办
根本原因不是 WebStorm 有问题，而是它没读到你系统里装的 Node.js 全局 bin 路径。Mac/Linux 用户尤其容易卡在这儿——终端能跑 ng，WebStorm 的 Terminal 或 Run Configuration 就找不到。
实操建议：
- 打开 Preferences → Tools → Terminal，把
Shell path改成你实际用的 shell 启动脚本，比如/bin/zsh -l（加-l表示 login shell，会加载~/.zshrc里的PATH） - Windows 用户检查是否勾选了
Start directory下的Use login shell（如果用 Git Bash）或确认PATH已包含%APPDATA%\npm - 别依赖 WebStorm 自动探测：手动在 Preferences → Languages & Frameworks → JavaScript → Angular CLI 里填入完整路径，比如
/usr/local/bin/ng或C:\Users\XXX\AppData\Roaming\npm\ng.cmd
运行 ng serve 时端口被占、热更新失效、控制台乱码
这些不是 Angular 的锅，是 WebStorm 的 Terminal 或内置服务配置和本地环境不一致导致的。
常见错误现象：
-
ERROR: Port 4200 is already in use—— WebStorm 默认复用同一个 Terminal 标签页，上次没关干净就又点 Run，ng serve实例还在后台跑 - 修改代码没刷新 —— WebStorm 的 Terminal 默认关闭了 stdin，导致
ng serve检测不到文件变化事件（尤其在 WSL 或 Docker 环境下） - 中文日志显示为
???—— Windows 上 CMD/PowerShell 编码不是 UTF-8，而 Angular CLI 输出用了 Unicode
实操建议：
- 每次运行前先按
Ctrl+C确认 Terminal 里没残留进程；或者改用Run → Edit Configurations → ng serve → Before launch → Run npm script → build，避免手敲 - 在
ng serve配置里加参数：--live-reload=true --live-reload-host=localhost --live-reload-port=49153，绕过 WebStorm 的 stdin 限制 - Windows 用户在 Terminal 设置里勾选
Override encoding，设为UTF-8；或直接用外部终端（右键菜单 →Open in Terminal）
WebStorm 不识别 @angular/cli 的 schematics（比如 ng generate component 报错）
本质是 WebStorm 没正确解析项目本地的 node_modules/@angular/cli，而是调用了全局 CLI，而全局 CLI 版本和项目不匹配时，schematics 路径就对不上。
使用场景：你在项目根目录执行 ng g c foo 正常，但用 WebStorm 的 Generate → Angular Component 弹窗就失败，提示 Schematic "component" not found。
实操建议：
- 进 Preferences → Languages & Frameworks → JavaScript → Angular CLI，把
Angular CLI package改成Project CLI（而不是 Global CLI） - 确保项目根目录有
angular.json，且其中"cli": { "packageManager": "npm" }和你实际用的包管理器一致（否则 WebStorm 会去错的node_modules找 schematics） - 如果用了 pnpm 或 yarn v3+，需要额外在
angular.json里显式指定"schematics": "./node_modules/@angular/cli/lib/config/schema.json"（CLI v15+ 后部分版本会漏掉这个路径推导）
为什么 ng build --watch 在 WebStorm 里不触发自动重编译
因为 WebStorm 的 Run Configuration 默认把 ng build --watch 当作一次性命令执行完就退出，不会持续监听 stdout/stderr，更不会响应文件变更信号。
性能影响：强行用 Execute script in context 或 Shell Script 类型配置，会导致 WebStorm 启动多个 watch 进程，磁盘 I/O 暴涨，CPU 占满。
实操建议：
- 别用 Run Configuration 跑
--watch；改用 Terminal 手动执行，并保持窗口开着 —— 这是最稳定的方式 - 如果非要集成进 IDE 流程，用
File Watchers插件替代：设置监听src/**/*.ts，触发命令npx ng build --configuration=development --no-watch（注意去掉--watch） - 开发阶段优先用
ng serve，它自带 HMR；ng build --watch主要用于 CI 或生成静态资源，不该出现在日常编码流里
真正麻烦的是跨平台路径解析和 CLI 版本锁定 —— ng 在不同 Node 版本、不同包管理器、不同 shell 初始化方式下，加载 schematics 和查找配置的行为差异很大，WebStorm 只是把这些差异暴露得更直白而已。
