如何为你的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 为例）

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

• “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）

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