VSCode内置NPM Scripts面板需满足三条件：项目根目录打开、package.json含有效scripts字段、VSCode≥1.72版；不显示主因是路径错误、文件被排除、scripts为空或PowerShell执行策略限制，需手动调出并检查环境一致性。
VSCode 本身不依赖插件就能在侧边栏一键运行 package.json 脚本，但必须满足三个硬性条件：项目根目录打开、package.json 存在且含有效 scripts、VSCode 版本 ≥ 1.72。
为什么 NPM Scripts 面板不显示？
这不是插件没装的问题，而是 VSCode 内置功能的触发条件未满足：
- 你打开的是子文件夹（比如只打开了
src/），不是含package.json的项目根目录 —— 必须用File > Open Folder…选对顶层文件夹 -
package.json文件被误加进了.vscode/settings.json的"files.exclude"或"search.exclude"，导致 VSCode “看不见”它 -
scripts字段为空对象{}或只有注释，VSCode 不认为它是“可执行脚本源”，面板直接跳过 - Windows 用户用了 PowerShell 但没设执行策略，终端卡在报错
ExecutionPolicy，面板加载失败（此时命令面板也调不出脚本列表）
如何手动唤出并固定 NPM Scripts 面板
它不会自动弹窗，得主动拉出来，而且首次启用后会常驻资源管理器底部：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入NPM: Focus on NPM Scripts View并回车 - 或点击左侧活动栏最下方的
…→ 勾选NPM Scripts（注意：这个选项只在检测到合法package.json后才出现） - 面板图标是
/npm，位置在资源管理器（Explorer）下方，不是扩展栏里 - 如果唤出后仍是空的，右键面板空白处选
Reload Scripts，或先Developer: Reload Window
双击运行 vs 右键运行的区别
看似都是“点一下就跑”，但底层行为完全不同，直接影响能否传参和复用终端：
- 双击脚本名：默认复用同一个集成终端，适合
dev这类长期监听的命令；但无法追加参数，比如不能npm run build -- --mode staging - 右键 →
Run Script in Terminal：新开一个终端标签页执行，适合一次性任务（如test），避免干扰正在运行的开发服务器 - 右键 →
Run Script with Arguments…：弹出输入框，只填参数部分（不含npm run xxx），比如输--host 0.0.0.0 --port 4173，VSCode 自动拼成完整命令 - 终端复用行为受设置
terminal.integrated.reuseTerminal控制，默认为true，改false可强制每次新开
快捷键绑定 npm run dev 这类高频脚本
别再靠记忆敲命令面板，直接绑组合键。关键在 args 字段必须是 JSON 对象，且脚本名要严格匹配 package.json 中定义的 key：
- 打开快捷键设置：
Ctrl+K Ctrl+S（Win/Linux）或Cmd+K Cmd+S（Mac） - 点右上角
{}图标，进入keybindings.json - 添加一条记录，例如绑定
Cmd+Alt+D到dev：{ "key": "cmd+alt+d", "command": "npm.runScript", "args": {"script": "dev"} } - 注意：
command是npm.runScript（不是workbench.action.terminal.runActiveFile），否则会执行当前文件而非 npm 脚本
真正容易被忽略的是 Node 环境一致性：如果你用 nvm 或 fnm 管理版本，VSCode 终端默认不加载 shell profile，which node 可能指向系统自带老版本。务必检查 terminal.integrated.profiles 设置，给 zsh/bash 加上 "args": ["-l"]，否则脚本执行时可能因 node 版本错乱而报 peer dep 错误。
