VSCode 的 NPM Scripts 侧边栏不显示或为空，主要因未识别有效 package.json：需打开文件夹根目录、确保 scripts 字段为合法对象、启用内置 npm 扩展、手动执行“npm: Refresh Scripts”命令。
为什么 npm scripts 侧边栏不出现或显示为空
VSCode 默认不会自动展示 package.json 里的脚本，必须启用内置的 NPM 脚本功能，且项目结构要满足基本识别条件。常见现象是：侧边栏「NPM Scripts」区域完全不显示、点击「+」无反应、或列表加载后为空——大概率不是插件问题，而是 VSCode 没识别到有效的 package.json。
实操建议：
- 确认当前打开的是**文件夹根目录**（不是单个
package.json文件），且该目录下存在合法的package.json（至少含"scripts"字段，哪怕为空对象） - 检查
package.json是否语法错误：VSCode 底部状态栏若显示 JSON 解析失败，npm scripts面板会静默失效 - 确保没有禁用 VSCode 内置扩展：
npm（ID 为vscode.npm），可在扩展面板中搜 “@builtin npm” 查看是否已启用
如何手动触发 npm scripts 面板加载
VSCode 不会常驻监听 package.json 变更，首次加载依赖用户主动操作。即使文件结构正确，也可能因缓存或焦点问题未初始化。
实操建议：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入并执行命令：npm: Refresh Scripts - 或者，在资源管理器中右键点击
package.json→ 选择「Refresh NPM Scripts」 - 如果仍为空，尝试关闭并重新打开该文件夹（不是重启 VSCode），避免工作区缓存干扰
scripts 字段格式错误导致加载失败
VSCode 的 npm 扩展对 scripts 字段的 JSON 结构敏感。常见错误不是语法错，而是字段类型或嵌套违规。
实操建议：
-
"scripts"必须是 object 类型，不能是null、string或缺失；空值写成"scripts": {}即可 - 避免在 script 值里使用未转义的换行或注释（JSON 不支持）；例如：
"dev": "vite\n# dev server"会解析失败 - 脚本名不要含空格或特殊字符（如
"build:prod:beta"合法，但"build prod"会导致该条脚本被跳过）
多根工作区下 npm scripts 面板只显示一个项目
VSCode 在多根工作区（.code-workspace）中，默认只激活第一个文件夹的 npm scripts。其余根目录的脚本不会合并显示，也不会自动切换。
实操建议：
- 点击侧边栏底部的
NPM Scripts标题右侧的「…」按钮，选择「Change Folder」手动切换目标文件夹 - 每个文件夹需单独执行一次
npm: Refresh Scripts，切换后不会自动刷新 - 如果某个子文件夹没有
package.json，或其scripts为空，则对应选项会灰显或不可选
真正卡住的地方往往不是配置多复杂，而是 VSCode 没把当前目录当“npm 项目”——它只认 package.json 存在且可解析、且你正处在它的父目录里。路径差一级、JSON 多了个逗号、甚至编辑器没聚焦到正确窗口，都可能导致面板沉默。
