VSCode不自动显示package.json脚本，必须满足三条件：项目根目录打开、scripts字段非空、VSCode≥1.72；不显示主因是路径错误、package.json被排除、scripts为空或PowerShell策略限制。
VSCode 本身不自动显示 package.json 里的所有脚本，必须满足三个硬性条件：项目根目录有 package.json、其中 scripts 字段非空、VSCode 已正确识别该工作区——缺一不可，否则侧边栏不会出现 NPM Scripts 面板，命令面板也搜不到脚本。
为什么 NPM Scripts 面板不显示？
最常见原因是 VSCode 没“看到”有效的 package.json：
- 你打开的是子文件夹（比如只打开了
src/），而不是包含package.json的项目根目录 -
package.json文件被.vscode/settings.json中的files.exclude或search.exclude错误屏蔽了 - VSCode 版本低于 1.72（该版本起才将 NPM Scripts 视图作为内置功能集成）
-
scripts字段为空对象{}或只含注释，VSCode 不认为它是可执行脚本源
验证方式：按 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Win/Linux），输入 NPM: Focus on Scripts View。如果命令不存在，说明环境未就绪；如果存在但面板空白，检查 package.json 路径和内容。
用命令面板运行脚本比侧边栏更可靠
侧边栏依赖 UI 渲染状态，而命令面板直接调用底层任务发现逻辑，响应更快、容错更强：
立即学习“前端免费学习笔记（深入）”；
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
- 确保终端焦点不在编辑器内（避免快捷键被拦截），再按
Cmd+Shift+P/Ctrl+Shift+P - 输入
NPM: Run Script，回车——此时会列出package.json中所有scripts键名 - 若脚本名含冒号（如
dev:server），能正常识别；但含空格（如"dev server"）会直接被跳过 - 执行后，VSCode 默认在新终端标签页中运行，输出实时可见；关闭该终端即终止进程（对
dev类长期服务尤其关键）
给 npm run dev 绑快捷键，别碰 tasks.json
为高频脚本配快捷键，最简路径是绕过任务系统，直连 npm.runScript 命令：
- 按
Cmd+K Cmd+S（Mac）或Ctrl+K Ctrl+S（Win/Linux）打开快捷键设置 - 点右上角
+，在“命令”栏输入npm.runScript - 在“键”栏按下组合键（例如
Cmd+Alt+D），在“参数”栏填：{"script":"dev"} - 保存后无需重启，下次直接按组合键即可触发——它等价于在命令面板选
NPM: Run Script再选dev，但少两步操作
注意：tasks.json 方式虽支持 problemMatcher 解析错误行号，但日常启动开发服务器完全没必要；反而容易因 type: "npm" 与本地 node_modules/.bin 路径不一致，导致 Cannot find module 报错。
终端里跑 npm run 仍是底线方案
当所有可视化方式失效（比如远程开发、WSL 权限异常、Shell 初始化失败），集成终端是最可控的兜底手段：
- 按
Ctrl+`唤出终端，确认当前路径是项目根目录（pwd或看终端标题） - 直接输
npm run dev，回车——不依赖 VSCode 的脚本发现机制，只依赖你终端里实际可用的npm和node - 若报
command not found: npm，说明终端没加载 Node 环境（如 nvm 未初始化），需先执行nvm use或检查~/.zshrc是否 source 了 nvm - Windows 用户若遇
.ps1 cannot be loaded，不是 VSCode 问题，是 PowerShell 执行策略限制，临时改用cmd或bash终端类型
真正容易被忽略的是：VSCode 启动的每个终端实例，其 Shell 环境彼此隔离。你在某个终端里 nvm use 18，只影响那个标签页；其他标签页仍用默认 Node 版本——这点在并行跑 dev 和 test:watch 时极易踩坑。
