首先创建并配置 launch.json 文件以控制程序调试方式，该文件位于项目根目录的 .vscode 文件夹中；通过点击“运行和调试”图标后选择环境可自动生成；其核心字段包括 name、type、request、program、cwd、args、env 和 console；以 Node.js 和 Python 为例，需正确设置入口文件和运行参数；使用时需安装对应语言调试扩展，推荐结合 ${workspaceFolder} 提高通用性，并可与 tasks.json 配合实现预构建任务。
为 VSCode 配置调试文件 launch.json，主要是通过设置启动参数来控制程序如何运行和调试。这个文件位于项目根目录下的 .vscode 文件夹中，VSCode 会根据你使用的语言和调试器自动生成或允许手动创建合适的配置。
1. 创建 launch.json 文件
打开你的项目后，按以下步骤操作：
- 点击左侧活动栏的“运行和调试”图标（一个虫子形状）
- 点击“运行和调试”上方的“创建 launch.json 文件”链接
- 选择对应的环境（如 Node.js、Python、C#、Go 等）
- VSCode 会自动生成一个基础的 launch.json 文件
如果文件已存在，可以直接编辑它。
2. 常见字段说明
launch.json 是一个 JSON 格式文件，包含多个可配置项。以下是常用字段解释：
- name：调试配置的名称，显示在调试下拉菜单中
- type：调试器类型，如 node、python、cppdbg 等
- request：请求类型，通常为 launch（启动程序）或 attach（附加到正在运行的进程）
- program：要运行的入口文件路径，如 ${workspaceFolder}/app.js
- cwd：程序运行时的工作目录，通常设为 ${workspaceFolder}
- args：传递给程序的命令行参数数组
- env：设置环境变量
- console：指定控制台类型，如 integratedTerminal（推荐，可在终端中交互）或 internalConsole
3. 示例配置
以下是一些常见语言的示例：
Node.js 项目：<font face='monospace'>{
"version": "0.2.0",
"configurations": [
{
"name": "启动应用",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/index.js",
"cwd": "${workspaceFolder}",
"console": "integratedTerminal"
}
]
}</font>
Python 项目：
<font face='monospace'>{
"version": "0.2.0",
"configurations": [
{
"name": "调试 Python",
"type": "python",
"request": "launch",
"program": "${workspaceFolder}/main.py",
"console": "integratedTerminal",
"args": ["--verbose"],
"env": {
"FLASK_ENV": "development"
}
}
]
}</font>
4. 调试技巧与注意事项
- 确保已安装对应语言的调试扩展（如 Python 扩展、Node.js 调试器等）
- 使用 ${workspaceFolder} 引用项目根目录，提高配置通用性
- 可以配置多个 configuration，方便切换不同启动方式
- 修改保存后，重启调试即可生效
- 配合 tasks.json 可实现预构建任务（如编译 TypeScript）
