如何为你的VSCode项目配置launch.json

为vscode项目配置launch.json的核心是明确调试环境、入口文件、参数及端口监听等指令，需确保本地运行时可用，推荐通过ide自动生成并按需调整type、program等字段。

为 vscode 项目配置 launch.json，核心是告诉调试器：用什么环境、运行哪个文件、传什么参数、是否监听端口等。它不难，但细节决定能否顺利启动调试。

确认项目已支持调试（比如有 node.js 或 python 环境）

VSCode 本身不自带运行时，launch.json 是“指令清单”，真正执行靠你本地装好的解释器或运行时。

• node.js 项目：确保终端里能运行 node --version
• Python 项目：确认已选好正确的 Python 解释器（Ctrl+Shift+P → “Python: select Interpreter”）
• typescript 项目：通常需先生成 js 文件（通过 tsc 或启用 outFiles 源码映射）

自动生成 launch.json（推荐新手）

别手动敲——VSCode 能根据当前语言和文件智能生成基础配置。

• 打开项目根目录下的一个可执行文件（如 index.js 或 main.py）
• 按 Ctrl+Shift+D 进入运行和调试视图
• 点击顶部的 “create a launch.json file” 链接
• 选择环境（如 “Node.js” 或 “Python”），再选模板（如 “Node.js: Launch Program”）
• VSCode 会在 .vscode/launch.json 中生成一个带注释的示例

常用字段说明（以 Node.js 为例）

生成后，你可以按需调整这些关键字段：

小麦企业网站展示系统1.1

小麦企业网站展示系统介绍：一、安装使用将xiaomai.sql导入数据库二、后台登录后台帐号，密码默认都是admin,config.php 配置文件可根据自行需要修改，IP地址，数据库用户名，密码，及表名后台目录默认admin，支持自行任意修改目录名三、注意事项1 本源码完全免费，采用伪静态，减少不必要的源码重复，速度更快，支持二次开发。2、注明本程序编码为UTF8，如发生乱码，请注意修改编码3、

2

查看详情

• “type”：调试器类型，如 "node"、"python"、"pwa-node"（新版 Node 推荐）
• “request”：是启动新进程（"launch"）还是附加到已有进程（"attach"）
• “name”：调试配置名，会显示在运行面板的下拉菜单中
• “program”：入口文件路径，建议用 ${workspaceFolder} 变量，如 "${workspaceFolder}/src/index.js"
• “console”：设为 "integratedTerminal" 可在 VSCode 终端里看到输出和交互
• “env”：添加环境变量，例如 "NODE_ENV": "development"
• “sourcemaps”（TS/Babel 项目）：设为 true，并确保构建时生成 .map 文件

多配置共存与切换

一个 launch.json 可包含多个配置，用逗号分隔，每次调试前在运行面板顶部下拉选择即可。

• 比如同时定义 “启动开发服务器” 和 “运行单元测试” 两个配置
• 每个配置的 "name" 必须唯一，方便识别
• 可配合 preLaunchTask 在调试前自动构建（需先配置 tasks.json）

基本上就这些。配置一次，后续调试点几下就能跑起来——关键是入口路径写对、运行时可用、源码映射配准。不复杂但容易忽略细节。