在 Visual Studio Code (VSCode) 中调试 Python 代码是一项常见的任务，下面是一个详细的步骤指南，帮助您在 VSCode 中设置并进行 Python 调试：

1. 安装必备软件

确保已安装以下组件：

• Python 解释器：在您的系统上安装 Python，可以从 Python 官方网站 下载并安装适合您操作系统的版本。
• VSCode：下载并安装最新版的 Visual Studio Code，可从 VSCode 官网 获取。

2. 安装 Python 扩展

在 VSCode 中安装 Python 扩展，以提供对 Python 语言的支持，包括智能提示、代码格式化以及调试功能。按以下步骤操作：

• 打开 VSCode。
• 点击左下角的 Extensions 图标（或通过菜单栏选择 View > Extensions）。
• 在搜索框中输入 “Python”，找到由 Microsoft 发布的官方 Python 扩展。
• 点击 “Install”（如果已安装则显示为 “Reload” 或 “Update”）。

3. 配置调试环境

创建一个 launch.json 文件来配置调试环境。这个文件告诉 VSCode 如何启动和连接到 Python 调试器。按照以下步骤创建或编辑 launch.json：

• 打开您要调试的 Python 文件所在的项目目录。
• 点击左侧活动栏的 Debug 图标（或通过菜单栏选择 View > Debug）。
• 如果首次使用调试功能，VSCode 会提示您创建 launch.json。点击提示中的 “Create a launch.json file” 按钮，然后选择 “Python” 环境。
• 如果已有 launch.json 文件，点击齿轮图标（或右键选择 “Add Configuration…”），然后选择 “Python”。

生成的 launch.json 文件通常包含一些预设的调试配置模板。您可以根据需要选择合适的配置（如 “Python File”、“Module” 或 “Integrated Terminal/Console”），或者自定义配置。典型的调试配置可能如下所示：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true,
            "cwd": "${workspaceFolder}",
            "env": {},
            "args": []
        }
    ]
}

• "name"：配置的名称，用于在调试面板中选择启动。
• "type"：调试器类型，这里应为 "python"。
• "request"：请求类型，通常设为 "launch" 表示启动一个新的 Python 进程进行调试。
• "program"：要调试的主程序文件路径，"${file}" 表示当前打开的文件。
• "console"：输出调试信息的终端类型，可以是 "integratedTerminal"（集成终端）或 "internalConsole"（内部调试控制台）。
• "justMyCode"：是否只调试自己的代码，true 表示忽略外部库的代码。
• "cwd"：工作目录，"${workspaceFolder}" 表示当前工作区根目录。
• "env"：环境变量，可以在这里添加或覆盖需要传递给调试进程的环境变量。
• "args"：传递给调试程序的命令行参数。

4. 设置断点

在您想要调试的代码行号左侧单击，即可设置一个断点。断点标记为红色圆圈，表示当程序执行到这一行时会暂停。

5. 启动调试

• 确保您打开了要调试的 Python 文件，并已设置好断点。
• 在 Debug 视图中，选择与您配置对应的调试任务（如上例中的 “Python: 当前文件”）。
• 点击绿色的三角形按钮（或使用快捷键 F5）启动调试。

当程序运行到断点处时，将会暂停执行，此时您可以进行以下操作：

• 查看变量：在 Variables 视图中查看当前作用域内的变量及其值。
• 步进：

• F10：Step Over，执行下一行代码，但不会进入函数或方法内部。
• F11：Step Into，执行下一行代码，并进入函数或方法内部。
• Shift + F11：Step Out，从当前函数或方法跳出，返回到调用处的下一行。

• 继续执行：点击 Continue 按钮（或使用 F5）继续执行，直到遇到下一个断点或程序结束。
• 监视表达式：在 Watch 视图中添加或编辑表达式，观察其在调试过程中的值变化。
• 控制台交互：在调试控制台中（如集成终端）输入命令与当前调试环境交互，如打印变量、修改变量值等。

通过以上步骤，您就可以在 Visual Studio Code 中顺利地调试 Python 代码了。如有需要，可根据具体项目需求进一步调整 launch.json 配置，以适应不同的调试场景。