参加你附近的 ，了解 VS Code 中的 AI 辅助开发。

Visual Studio Code 调试配置

对于复杂的调试场景或应用程序，您需要创建一个 launch.json 文件来指定调试器配置。例如，指定应用程序入口点、附加到正在运行的应用程序或设置环境变量。

要了解有关 VS Code 中调试的更多信息，请参阅Visual Studio Code 中的调试。

提示

VS Code 中的 Copilot 可以帮助您为项目创建启动配置。有关使用 Copilot 生成启动配置的更多信息。

启动配置

对于简单的应用程序或调试场景，您可以在没有特定调试配置的情况下运行和调试程序。使用F5 键，VS Code 将尝试运行您当前活动的文件。

但是，对于大多数调试场景，您需要创建一个调试配置（启动配置）。例如，指定应用程序入口点、附加到正在运行的应用程序或设置环境变量。创建启动配置文件也很有益，因为它允许您配置和保存项目的调试设置详细信息。

VS Code 将调试配置信息存储在工作区（项目根文件夹）中 .vscode 文件夹下的 launch.json 文件中，或者存储在您的用户设置或工作区设置中。

以下代码片段描述了调试 Node.js 应用程序的示例配置

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}\\app.js"
    }
  ]
}

VS Code 还支持复合启动配置，用于同时启动多个配置。

注意

即使您没有在 VS Code 中打开文件夹，您也可以调试一个简单的应用程序，但无法管理启动配置和设置高级调试。

创建调试配置文件

要创建初始的 launch.json 文件

  1. 在“运行和调试”视图中选择创建 launch.json 文件。

    launch configuration

  2. VS Code 尝试检测您的调试环境。如果无法检测到，您可以手动选择

    debug environment selector

    根据选定的调试环境，VS Code 会在 launch.json 文件中创建一个入门配置。

  3. 在资源管理器视图中（⇧⌘E (Windows, Linux Ctrl+Shift+E)），请注意 VS Code 在您的工作区中创建了一个 .vscode 文件夹并添加了 launch.json 文件。

    launch.json in Explorer

您现在可以编辑 launch.json 文件以添加更多配置或修改现有配置。

向 launch.json 添加配置

要向现有 launch.json 添加新配置，请使用以下技术之一

  • 按添加配置按钮，然后选择一个代码片段以添加预定义配置。
  • 如果光标位于配置数组内，请使用 IntelliSense。
  • 选择运行 > 添加配置菜单选项。

launch json suggestions

使用 AI 生成启动配置

使用 VS Code 中的 Copilot，您可以加速为项目创建启动配置的过程。要使用 Copilot 生成启动配置

  1. 使用⌃⌘I (Windows, Linux Ctrl+Alt+I) 打开聊天视图，或从标题栏中的 Copilot 菜单中选择打开聊天。

  2. 输入 /startDebugging 聊天提示以生成调试配置。

    或者，您还可以输入自定义提示，例如 generate a debug config for an express app #codebase。

    如果您的工作区包含不同语言的文件，这会很有用。

    注意

    #codebase 聊天变量为 Copilot 提供了项目上下文，这有助于其生成更准确的响应。

  3. 应用建议的配置，然后开始调试。

使用启动配置启动调试会话

要使用启动配置启动调试会话

  1. 在运行和调试视图中，使用配置下拉列表选择名为启动程序的配置。

    可用配置列表与 launch.json 文件中的配置相匹配。

    Screenshot that shows the launch configuration dropdown.

  2. 使用F5 启动调试会话，或在运行和调试视图中选择开始调试（播放图标）。

或者，您可以通过命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）运行您的配置，方法是筛选调试：选择并开始调试或键入'debug '并选择您要调试的配置。

启动与附加配置

在 VS Code 中，有两种核心调试模式，启动和附加，它们处理两种不同的工作流和开发人员群体。根据您的工作流，知道哪种类型的配置适合您的项目可能会令人困惑。

如果您有浏览器开发人员工具的背景，您可能不习惯“从您的工具启动”，因为您的浏览器实例已经打开。当您打开 DevTools 时，您只是将 DevTools 附加到您打开的浏览器选项卡。另一方面，如果您有服务器或桌面背景，让您的编辑器为您启动进程，并且您的编辑器自动将其调试器附加到新启动的进程是很正常的。

解释启动和附加之间区别的最佳方法是将启动配置视为如何在 VS Code 附加到应用程序之前以调试模式启动应用程序的配方，而附加配置是关于如何将 VS Code 的调试器连接到已经运行的应用程序或进程的配方。

VS Code 调试器通常支持以调试模式启动程序或附加到已在调试模式下运行的程序。根据请求（attach 或 launch），需要不同的属性，VS Code 的 launch.json 验证和建议应该有助于解决这个问题。

Launch.json 属性

有许多 launch.json 属性可用于支持不同的调试器和调试场景。一旦您为 type 属性指定了值，您可以使用 IntelliSense（⌃Space (Windows, Linux Ctrl+Space)）查看可用属性列表。启动配置中可用的属性因调试器而异。

launch json suggestions

适用于一个调试器的属性不会自动适用于其他调试器。如果您在启动配置中看到红色波浪线，请将鼠标悬停在上面以了解问题并尝试在启动调试会话之前修复它们。

以下属性是每个启动配置的强制属性

  • type - 用于此启动配置的调试器类型。每个已安装的调试扩展都会引入一个类型：例如，内置 Node 调试器为 node，PHP 和 Go 扩展为 php 和 go。
  • request - 此启动配置的请求类型。目前支持 launch 和 attach。
  • name - 显示在调试启动配置下拉菜单中的易读名称。

以下是一些适用于所有启动配置的可选属性

  • presentation - 使用 presentation 对象中的 order、group 和 hidden 属性，您可以在调试配置下拉菜单和调试快速选择中对配置和复合项进行排序、分组和隐藏。
  • preLaunchTask - 在调试会话开始之前启动任务，将此属性设置为 tasks.json（在工作区的 .vscode 文件夹中）中指定的任务的标签。或者，可以将其设置为 ${defaultBuildTask} 以使用您的默认构建任务。
  • postDebugTask - 在调试会话结束时启动任务，将此属性设置为 tasks.json（在工作区的 .vscode 文件夹中）中指定的任务的名称。
  • internalConsoleOptions - 此属性控制调试会话期间调试控制台面板的可见性。
  • debugServer - 仅适用于调试扩展作者：此属性允许您连接到指定的端口而不是启动调试适配器。
  • serverReadyAction - 如果您希望在调试程序向调试控制台或集成终端输出特定消息时在 Web 浏览器中打开 URL。有关详细信息，请参阅下面的调试服务器程序时自动打开 URI 部分。

许多调试器支持以下一些属性

  • program - 启动调试器时要运行的可执行文件或文件
  • args - 传递给要调试的程序的参数
  • env - 环境变量（值 null 可用于“取消定义”变量）
  • envFile - 包含环境变量的 dotenv 文件的路径
  • cwd - 用于查找依赖项和其他文件的当前工作目录
  • port - 附加到正在运行的进程时的端口
  • stopOnEntry - 程序启动时立即中断
  • console - 要使用的控制台类型，例如 internalConsole、integratedTerminal 或 externalTerminal

变量替换

VS Code 将常用的路径和其他值作为变量提供，并支持 launch.json 中字符串内的变量替换。这意味着您不必在调试配置中使用绝对路径。例如，${workspaceFolder} 提供工作区文件夹的根路径，${file} 提供活动编辑器中打开的文件，${env:Name} 提供环境变量“Name”。

您可以在变量参考中查看预定义变量的完整列表，或者通过在 launch.json 字符串属性中调用 IntelliSense。

{
  "type": "node",
  "request": "launch",
  "name": "Launch Program",
  "program": "${workspaceFolder}/app.js",
  "cwd": "${workspaceFolder}",
  "args": ["${env:USERNAME}"]
}

平台特定属性

VS Code 支持定义调试配置设置（例如，要传递给程序的参数），这些设置取决于调试器运行的操作系统。为此，请在 launch.json 文件中放置一个平台特定文字，并在该文字中指定相应的属性。

以下示例显示了如何在 Windows 上以不同方式将 "args" 传递给程序

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "program": "${workspaceFolder}/node_modules/gulp/bin/gulpfile.js",
      "args": ["myFolder/path/app.js"],
      "windows": {
        "args": ["myFolder\\path\\app.js"]
      }
    }
  ]
}

有效的操作系统属性是 Windows 的 "windows"、Linux 的 "linux" 和 macOS 的 "osx"。在操作系统特定范围内定义的属性会覆盖在全局范围内定义的属性。

type 属性不能放置在平台特定部分中，因为 type 间接决定了远程调试场景中的平台，这将导致循环依赖。

在以下示例中，调试程序始终在入口处停止，除了 macOS

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "program": "${workspaceFolder}/node_modules/gulp/bin/gulpfile.js",
      "stopOnEntry": true,
      "osx": {
        "stopOnEntry": false
      }
    }
  ]
}

全局启动配置

您可以定义适用于所有工作区的启动配置。要指定全局启动配置，请在您的 launch 用户设置中添加一个启动配置对象。然后，此 launch 配置将在您的工作区中共享。例如

"launch": {
    "version": "0.2.0",
    "configurations": [{
        "type": "node",
        "request": "launch",
        "name": "Launch Program",
        "program": "${file}"
    }]
}

重定向输入/输出到/来自调试目标

重定向输入/输出是调试器或运行时特定的，因此 VS Code 没有适用于所有调试器的内置解决方案。

以下是您可能要考虑的两种方法

  • 在终端或命令提示符中手动启动要调试的程序（“调试目标”），并根据需要重定向输入/输出。确保向调试目标传递适当的命令行选项，以便调试器可以附加到它。创建并运行一个“附加”调试配置，该配置附加到调试目标。

  • 如果您使用的调试器扩展可以在 VS Code 的集成终端（或外部终端）中运行调试目标，您可以尝试将 shell 重定向语法（例如，“<”或“>”）作为参数传递。

    这是一个 launch.json 配置示例

    {
  "name": "launch program that reads a file from stdin",
  "type": "node",
  "request": "launch",
  "program": "program.js",
  "console": "integratedTerminal",
  "args": ["<", "in.txt"]
}

    此方法要求 < 语法通过调试器扩展传递，并最终在集成终端中保持不变。

复合启动配置

启动多个调试会话的另一种方法是使用复合启动配置。您可以在 launch.json 文件中的 compounds 属性中定义复合启动配置。

使用 configurations 属性列出应并行启动的两个或更多启动配置的名称。

可选地，指定一个 preLaunchTask 任务，该任务在单个调试会话开始之前运行。布尔标志 stopAll 控制手动终止一个会话是否停止所有复合会话。

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Server",
      "program": "${workspaceFolder}/server.js"
    },
    {
      "type": "node",
      "request": "launch",
      "name": "Client",
      "program": "${workspaceFolder}/client.js"
    }
  ],
  "compounds": [
    {
      "name": "Server/Client",
      "configurations": ["Server", "Client"],
      "preLaunchTask": "${defaultBuildTask}",
      "stopAll": true
    }
  ]
}

复合启动配置也显示在启动配置下拉菜单中。

调试服务器程序时自动打开 URI

开发 Web 程序通常需要在 Web 浏览器中打开特定 URL，以便在调试器中命中文本代码。VS Code 具有内置功能“serverReadyAction”来自动化此任务。

以下是一个简单的 Node.js Express 应用程序示例

var express = require('express');
var app = express();

app.get('/', function(req, res) {
  res.send('Hello World!');
});

app.listen(3000, function() {
  console.log('Example app listening on port 3000!');
});

此应用程序首先为“/”URL 安装一个“Hello World”处理程序，然后开始侦听端口 3000 上的 HTTP 连接。端口在调试控制台中宣布，通常，开发人员现在会在他们的浏览器应用程序中键入 https://:3000。

serverReadyAction 功能允许将结构化属性 serverReadyAction 添加到任何启动配置并选择要执行的“操作”

{
  "type": "node",
  "request": "launch",
  "name": "Launch Program",
  "program": "${workspaceFolder}/app.js",

  "serverReadyAction": {
    "pattern": "listening on port ([0-9]+)",
    "uriFormat": "https://:%s",
    "action": "openExternally"
  }
}

这里的 pattern 属性描述了用于匹配程序输出字符串的正则表达式，该字符串宣布了端口。端口号的模式放在括号中，以便它作为正则表达式捕获组可用。在此示例中，我们只提取端口号，但也可以提取完整的 URI。

uriFormat 属性描述了端口号如何转换为 URI。第一个 %s 被匹配模式的第一个捕获组替换。

然后，生成的 URI 会在 VS Code 外部（“外部”）使用为 URI 方案配置的标准应用程序打开。

通过 Microsoft Edge 或 Chrome 触发调试

或者，可以将 action 设置为 debugWithEdge 或 debugWithChrome。在此模式下，可以添加一个 webRoot 属性，该属性会传递给 Chrome 或 Microsoft Edge 调试会话。

为了简化一点，大多数属性是可选的，我们使用以下回退值

  • pattern："listening on.* (https?://\\S+|[0-9]+)"，它匹配常用的消息“listening on port 3000”或“Now listening on: https://:5001”。
  • uriFormat："https://:%s"
  • webRoot："${workspaceFolder}"

触发任意启动配置

在某些情况下，您可能需要为浏览器调试会话配置更多选项，或完全使用不同的调试器。您可以通过将 action 设置为 startDebugging 并将 name 属性设置为当 pattern 匹配时要启动的启动配置的名称来实现此目的。

命名启动配置必须与具有 serverReadyAction 的配置位于同一文件或文件夹中。

以下是实际运行中的serverReadyAction 功能

后续步骤

  • 任务 - 描述如何使用 Gulp、Grunt 和 Jake 运行任务以及如何显示错误和警告。
  • 变量参考 - 描述 VS Code 中可用的变量。

常见问题

我在“运行和调试”视图下拉菜单中看不到任何启动配置。哪里出错了？

最常见的问题是您没有设置 launch.json 或者该文件存在语法错误。另外，您可能需要打开一个文件夹，因为无文件夹调试不支持启动配置。

10/09/2025
© . This site is unofficial and not affiliated with Microsoft.