VSCode自带NPM Scripts面板默认不显示，需手动调出且仅识别项目根目录下含非空scripts字段的package.json；不显示主因是未打开根目录、scripts为空、多根工作区焦点错位或VSCode版本过低。
VSCode 自带的 NPM Scripts 面板能直接列出 package.json 里的 scripts，但默认不显示、不自动刷新、点不了——得手动启用并注意工作区上下文。
为什么 NPM Scripts 面板不出现？
VSCode 不会自动打开这个面板，它藏在侧边栏底部，且只在当前打开的文件夹含有效 package.json 时才激活。常见失效原因：
- 没打开项目根目录（即含
package.json的文件夹），而是只打开了某个子文件 -
package.json里没有scripts字段，或字段为空对象{} - 工作区是多根工作区（multi-root workspace），但当前焦点不在含
package.json的文件夹内 - VSCode 版本过低（
1.70+才稳定支持该面板）
怎么调出并正确使用 NPM Scripts 面板？
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 npm scripts，选中 npm: Toggle Script Explorer 即可唤出面板。之后它会固定在侧边栏底部，图标是 ?。
- 面板只读取当前活动文件夹（即资源管理器顶部路径）下的
package.json - 右键脚本名可
Run Script、Debug Script（需配置launch.json）、Copy Script - 双击脚本名等效于执行
npm run，输出直接进集成终端 - 若脚本依赖环境变量（如
NODE_ENV=production），需在settings.json中配"npm.packageManager": "npm"并确保终端 shell 与 VSCode 一致
运行时报错 “command not found” 或卡住怎么办？
这类问题几乎都源于终端上下文和 Node/npm 环境不匹配，而非脚本本身写错：
- VSCode 终端可能用了系统自带旧版 npm（比如 macOS 的
/usr/bin/npm），而你用 nvm 安装的是另一个版本——检查终端里which npm和npm --version，再对比面板执行后终端输出的第一行路径 - 某些脚本（如
predev、postbuild）会被自动触发，但面板里不显式列出；想确认是否执行，加echo "predev ran"到脚本里观察终端输出 - 如果脚本含交互命令（如
inquirer），直接双击会失败——必须右键选Run Script in Terminal，否则 stdin 被阻塞 - 面板执行脚本时不会加载
.env文件（dotenv包需脚本内部自行 require），别指望它自动注入
能不能自定义脚本排序或过滤？
不能。VSCode 的 NPM Scripts 面板按 package.json 中 scripts 对象的键名**字典序排列**，且不支持隐藏、分组、搜索或拖拽重排。
- 想让常用脚本靠前？把它们的 key 名改成
a:dev、b:test这类前缀 - 想区分类型？可以加注释字段（VSCode 不识别，但人眼可读）：
"// dev tools": "", "dev": "vite" - 真正需要复杂管理时，不如用
npm-run-all或just替代，VSCode 面板只是快捷入口，不是脚本编排工具
最常被忽略的一点：NPM Scripts 面板不会监听 package.json 变更。改完 scripts 后，得手动右键面板空白处选 Refresh，或者关掉再打开面板——它不热更新。
