VSCode 的 NPM Scripts 侧边栏不显示或为空，主要因未识别有效 package.json：需打开文件夹根目录、确保 scripts 字段为合法对象、启用内置 npm 扩展、手动执行“npm: Refresh Scripts”命令。
为什么
侧边栏不出现或显示为空
VSCode 默认不会自动展示
里的脚本，必须启用内置的 NPM 脚本功能，且项目结构要满足基本识别条件。常见现象是：侧边栏「NPM Scripts」区域完全不显示、点击「+」无反应、或列表加载后为空——大概率不是插件问题，而是 VSCode 没识别到有效的
。
实操建议：
确认当前打开的是**文件夹根目录**（不是单个
文件），且该目录下存在合法的
（至少含
字段，哪怕为空对象）
检查
是否语法错误：VSCode 底部状态栏若显示 JSON 解析失败，
面板会静默失效
确保没有禁用 VSCode 内置扩展：
（ID 为
），可在扩展面板中搜 “@builtin npm” 查看是否已启用
如何手动触发
面板加载
VSCode 不会常驻监听
变更，首次加载依赖用户主动操作。即使文件结构正确，也可能因缓存或焦点问题未初始化。
实操建议：
按
（Win/Linux）或
（Mac），输入并执行命令：
或者，在资源管理器中右键点击
→ 选择「Refresh NPM Scripts」
如果仍为空，尝试关闭并重新打开该文件夹（不是重启 VSCode），避免工作区缓存干扰
字段格式错误导致加载失败
VSCode 的
扩展对
字段的 JSON 结构敏感。常见错误不是语法错，而是字段类型或嵌套违规。
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
实操建议：
必须是 object 类型，不能是
、
或缺失；空值写成
即可
避免在 script 值里使用未转义的换行或注释（JSON 不支持）；例如：
会解析失败
脚本名不要含空格或特殊字符（如
合法，但
会导致该条脚本被跳过）
多根工作区下
面板只显示一个项目
VSCode 在多根工作区（.code-workspace）中，默认只激活第一个文件夹的
。其余根目录的脚本不会合并显示，也不会自动切换。
实操建议：
点击侧边栏底部的
标题右侧的「…」按钮，选择「Change Folder」手动切换目标文件夹
每个文件夹需单独执行一次
，切换后不会自动刷新
如果某个子文件夹没有
，或其
为空，则对应选项会灰显或不可选
真正卡住的地方往往不是配置多复杂，而是 VSCode 没把当前目录当“npm 项目”——它只认
存在且可解析、且你正处在它的父目录里。路径差一级、JSON 多了个逗号、甚至编辑器没聚焦到正确窗口，都可能导致面板沉默。
npm scriptspackage.jsonpackage.jsonpackage.jsonpackage.json"scripts"package.jsonnpm scriptsnpmvscode.npmnpm scriptspackage.jsonCtrl+Shift+PCmd+Shift+Pnpm: Refresh Scriptspackage.jsonscriptsnpmscripts"scripts"nullstring"scripts": {}"dev": "vite\n# dev server""build:prod:beta""build prod"npm scriptsnpm scriptsNPM Scriptsnpm: Refresh Scriptspackage.jsonscriptspackage.json