vscode的npm scripts面板需手动唤起且仅识别项目根目录下含有效scripts字段的package.json；常见不显示原因包括打开子目录、package.json被排除、scripts为空或语法错误，可通过命令面板执行“npm: focus on scripts view”调出并固定。
VSCode 的 NPM Scripts 面板不是默认常驻的，必须手动唤起或配置激活；它只认项目根目录下的 package.json 里的 scripts 字段，且不跨文件夹查找。
为什么左侧没有「NPM Scripts」面板
最常见原因是 VSCode 没“看到”有效的 package.json：
- 你打开的是子目录（比如
src/或packages/my-lib），而不是package.json所在的根文件夹 -
package.json被.vscode/settings.json中的"files.exclude"错误屏蔽了（例如写了"**/package.json": true） -
scripts字段为空对象{}、是null，或语法错误导致解析失败（VSCode 不报错但会静默忽略） - 你用的是多根工作区（.code-workspace），但 VSCode 只对第一个文件夹启用 NPM Scripts 视图
验证方式：在集成终端里执行 cat package.json | head -5，确认文件存在、路径正确、scripts 有内容。
怎么手动调出并固定 NPM Scripts 面板
它不会自动弹出，也没有开关按钮——得靠命令面板触发：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入
NPM: Focus on Scripts View并回车（注意不是 “Toggle”，那是旧版命令） - 面板会出现在资源管理器底部；如果没显示，再点资源管理器顶部的
⋯→ 勾选NPM Scripts - 想让它每次打开都出现？目前无原生设置项，只能每次手动唤起或绑定快捷键（见下一条）
⚠️ 刷新脚本列表：右键面板空白处选 Refresh，或执行 Developer: Reload Window —— 修改 package.json 后有时不会热更新。
给 npm run dev 这类脚本配快捷键
高频脚本值得一键触发，不用翻面板、不输命令：
- 按
Ctrl+K Ctrl+S（Windows/Linux）或Cmd+K Cmd+S（macOS）打开快捷键设置 - 点右上角
+，在“命令”栏输入npm.runScript - 在“键”栏按下组合键（如
Ctrl+Alt+D） - 在“参数”栏填：
{"script":"dev"}（把dev换成你要绑的脚本名）
注意：npm.runScript 是内置命令，无需装扩展；但参数必须是合法 JSON 对象，引号不能少，值不能含空格或特殊字符（比如 "build:prod" 可以，"build prod" 会失败）。
面板点击后没反应或报错 npm not found
这和终端环境强相关，不是面板本身的问题：
- 检查集成终端是否用了正确的 Shell：VSCode 默认可能启用了 PowerShell，而你用
nvm切的 Node 版本只对 Command Prompt 或 bash 生效 - 在终端里运行
which node和echo $PATH，对比系统终端输出是否一致；不一致就说明 Shell 初始化没加载 nvm/fnm 配置 - Windows 用户常见报错：
npm : 无法加载文件 npm.ps1，因为在此系统上禁止运行脚本→ 在 PowerShell 中运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 右键脚本选
Run Script in Terminal，看真实错误输出；有时候面板静默失败，终端里反而有线索
复杂点在于：VSCode 的 NPM Scripts 面板本质只是个 UI 封装，背后完全依赖终端环境。它不管理 Node 版本，也不校验 peer deps，所有执行逻辑都交给 shell —— 所以环境问题永远比面板配置更优先。
