如何为VSCode配置调试配置文件（launch.json）？

技术教程
2025-09-28 16:40:02

首先创建并配置 launch.json 文件以控制程序调试方式，该文件位于项目根目录的 .vscode 文件夹中；通过点击“运行和调试”图标后选择环境可自动生成；其核心字段包括 name、type、request、program、cwd、args、env 和 console；以 Node.js 和 Python 为例，需正确设置入口文件和运行参数；使用时需安装对应语言调试扩展，推荐结合 ${workspaceFolder} 提高通用性，并可与 tasks.json 配合实现预构建任务。

如何为vscode配置调试配置文件（launch.json）？

为 VSCode 配置调试文件 launch.json，主要是通过设置启动参数来控制程序如何运行和调试。这个文件位于项目根目录下的 .vscode 文件夹中，VSCode 会根据你使用的语言和调试器自动生成或允许手动创建合适的配置。

1. 创建 launch.json 文件

打开你的项目后，按以下步骤操作：

点击左侧活动栏的“运行和调试”图标（一个虫子形状）
点击“运行和调试”上方的“创建 launch.json 文件”链接
选择对应的环境（如 Node.js、Python、C#、Go 等）
VSCode 会自动生成一个基础的 launch.json 文件

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

云模块网站管理系统3.1.03

云模块_YunMOK网站管理系统采用PHP+MYSQL为编程语言，搭载自主研发的模块化引擎驱动技术，实现可视化拖拽无技术创建并管理网站！如你所想，无限可能，支持创建任何网站：企业、商城、O2O、门户、论坛、人才等一块儿搞定！永久免费授权，包括商业用途；默认内置三套免费模板。PC网站+手机网站+适配微信+文章管理+产品管理+SEO优化+组件扩展+NEW Login界面.....目测已经遥遥领先..

0 查看详情云模块网站管理系统3.1.03

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>