WebStorm右键package.json无“Add Dependency”是因未正确识别为Node.js项目，需确保package.json被解析且绑定Node.js SDK；更新不改版本号系遵循npm语义化版本规则，如"^4.17.21"升至4.18.0无需修改package.json。
WebStorm 能图形化管理 npm 依赖，但默认行为和常见操作逻辑跟命令行有差异——不理解这点，容易误删包、版本不更新、或以为“功能失效”。
右键 package.json 为什么没 “Add Dependency”？
这个选项只在 WebStorm 正确识别项目为 Node.js 项目时才出现。核心前提是：package.json 必须被 IDE 解析为 JSON 文件，且项目已绑定 Node.js SDK。
- 检查
Settings → Editor → File Types → JSON是否包含*.json模式（不是package.json单文件） - 打开
File → Project Structure → Project → Project SDK，确认选中的是 Node.js SDK，而非普通 JDK - 如果刚新建项目，先保存
package.json再右键——未保存的文件不会触发上下文菜单
点了 “Update to x.x.x” 但 package.json 没变
这是 npm 语义化版本（semver）机制决定的，不是 WebStorm 的 bug。例如你写的是 "lodash": "^4.17.21"，点更新到 4.18.0，它会直接装进 node_modules，但不会改 package.json——因为 ^ 已允许该范围升级。
- 想锁死版本？手动把
^4.17.21改成4.17.21（去掉前缀），再右键 → Reload project - 想强制升到 5.x？得先删掉
^，改成5.0.0，保存后右键package.json→ “Reload project”，IDE 才会触发重装 - WebStorm 不会自动执行
npm install --save或--save-dev，它调用的是npm install，依赖类型由package.json字段决定
依赖列表里包名是灰色的，能删吗？
灰色 ≠ 未安装，而是 WebStorm 静态扫描发现该包在当前项目代码里没被 require() 或 import 过。它只是提示“可能冗余”，不是判断依据。
- 别仅凭颜色删包——比如某些包是构建工具插件（如
eslint-plugin-vue），代码里确实不 import，但 CLI 运行时需要 - 真正判断是否可删：查
package.json的dependencies/devDependencies字段；再搜项目里是否有require('xxx')或import ... from 'xxx' - 删完记得右键
package.json→ “Reload project”，否则 WebStorm 仍显示旧状态
批量更新过期包怎么操作？
WebStorm 没有“一键全量升级”，但可以高效筛选+合并安装，避免逐个点。
- 打开 Project Tool Window（
Alt+1），展开Dependencies节点 - 点顶部漏斗图标 → 勾选
Outdated only，立刻过滤出所有可更新项 - 按住
Ctrl多选几个包 → 右键 → “Update to x.x.x”，WebStorm 会生成一条npm install pkg1@x pkg2@y ...命令一次执行 - 注意：不要全选更新，尤其跨主版本（如 v4 → v5）可能破坏兼容性；优先处理带 ? 图标的“安全更新”
最常被忽略的一点：WebStorm 的依赖操作全部基于你系统 PATH 里的 npm 版本，不是它内置的 Node.js 解释器。终端里 npm -v 输出什么，IDE 就用什么——换源、切版本、甚至用 pnpm，都得先在终端配好，WebStorm 才能感知到。
