### VSCode 调试 Python 常见问题及解决方案 #### 1. 无法启动调试会话 当尝试在 VSCode 中启动调试时，可能会遇到以下错误信息：“The debug server has started and you can now use VS Code to attach to the application for debugging”[^1]。此问题通常与调试配置文件 `launch.json` 的设置不正确有关。确保 `launch.json` 文件中包含正确的调试配置，并且指定的脚本路径有效。 正确的调试配置示例： ```json { "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal" } ] } ``` #### 2. 无法找到调试适配器 如果在启动调试时出现“Couldn’t find a debug adapter descriptor for the debug type ‘python’ (extension might have failed to activate)”[^2]，这通常是因为 Python 扩展未正确安装或未激活。解决方法包括重新安装 Python 扩展，并确保扩展已成功加载。 #### 3. 远程调试失败 在远程服务器上进行调试时，可能会遇到调试失败的问题。主要原因是远程服务器上未安装 Python 扩展。解决方法是通过快捷键 `Ctrl+Shift+X` 打开扩展市场，搜索并安装 Microsoft 官方提供的 Python 扩展[^3]。安装完成后，重启 VSCode 以确保扩展生效。 #### 4. 调试过程中断点无效 断点无效通常是由于以下原因之一： - 脚本未正确加载。 - 调试配置中的 `program` 路径不正确。 - 使用了优化编译的代码版本。 确保调试配置中的 `justMyCode` 设置为 `false`，以便调试器能够跟踪所有代码，包括标准库和第三方库[^4]。 修改后的配置示例： ```json { "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal", "justMyCode": false } ] } ``` #### 5. 输出结果未显示 如果调试过程中未看到预期的输出结果，可能是由于以下原因： - 使用了错误的控制台类型。 - 脚本中的打印语句被跳过。 确保 `launch.json` 中的 `console` 字段设置为 `integratedTerminal` 或 `internalConsole`，以捕获所有输出。 #### 示例代码 以下是一个简单的调试示例代码： ```python def calculate(a, b): result = a + b return result def main(): x = 2 y = 22 z = calculate(x, y) print(f'结果是：{z}') if __name__ == '__main__': main() ``` ---