首先创建并配置 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 文件

如果文件已存在，可以直接编辑它。

标贝悦读AI配音

在线文字转语音软件-专业的配音网站

20

查看详情

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）

基本上就这些。只要选对 type 和正确设置入口文件，launch.json 就能顺利工作。