VSCode内置NPM脚本管理器支持查看、运行和调试package.json脚本,需手动刷新列表、配置终端复用、右键传参/环境变量,并通过launch.json配置调试。
vscode 内置的 npm 脚本管理器(npm scripts explorer)能让你不离开编辑器就快速查看、运行和调试 package.json 中定义的脚本,省去频繁切终端、敲命令的麻烦。用好它,关键在理解它的行为逻辑和几个实用操作细节。
脚本列表自动刷新有前提
VSCode 不会实时监听 package.json 变化,修改脚本后需要手动触发刷新,否则新脚本不会出现在侧边栏里。
- 点击 NPM 脚本视图右上角的 刷新图标(两个带箭头的圆圈)
- 或按快捷键 Ctrl+R(Windows/Linux) / Cmd+R(macOS)
- 确保当前打开的文件夹是包含 package.json 的项目根目录(不是子文件夹)
双击运行脚本时默认不启用终端复用
每次双击脚本,VSCode 都会新开一个集成终端面板。如果想复用同一个终端(比如连续运行 build → serve),可以这样设置:
- 打开 VSCode 设置(Ctrl+,),搜索 npm script terminal
- 勾选 Npm > Script: Terminal Reuse
- 或者在 settings.json 中添加:"npm.script.terminal.reuse": true
支持带参数和环境变量的快捷执行
直接双击只能运行无参脚本。要传参或设环境变量,得右键脚本 → 选择 Run Script in Terminal,然后在终端里手动补全:
ECTouch是上海商创网络科技有限公司推出的一套基于 PHP 和 MySQL 数据库构建的开源且易于使用的移动商城网店系统!应用于各种服务器平台的高效、快速和易于管理的网店解决方案,采用稳定的MVC框架开发,完美对接ecshop系统与模板堂众多模板,为中小企业提供最佳的移动电商解决方案。ECTouch程序源代码完全无加密。安装时只需将已集成的文件夹放进指定位置,通过浏览器访问一键安装,无需对已有
- 例如脚本 "dev": "vite",右键运行后可立刻输入 --host 0.0.0.0 --port 3001
- 如需临时加环境变量,可在终端中先执行:NODE_ENV=production npm run build(Linux/macOS)或 set NODE_ENV=production && npm run build(Windows)
调试脚本需额外配置 launch.json
NPM 脚本管理器本身不提供调试功能。要断点调试 Node.js 类型的脚本(比如自定义 CLI 工具或 Jest 测试),需要手动配置 .vscode/launch.json:
- 选择 Run → Add Configuration… → Node.js: NPM Script
- 选择目标脚本名(如 test),VSCode 会自动生成配置项
- 保存后,该脚本旁会出现绿色虫子图标,点击即可启动调试会话
基本上就这些。不复杂但容易忽略——尤其是刷新机制和终端复用,调通一次,后续效率提升很明显。









