You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何配置VSCode通过WSL调试Python?修改Cpp配置无效求方案

嘿,我之前也踩过WSL下VSCode调试Python的坑,你改Cpp的配置没成太正常了——毕竟C++用的是gdb/lldb,Python依赖的是debugpy,俩配置逻辑完全不搭边。下面给你一套我亲测有效的配置步骤,跟着来肯定能搞定:

第一步:先把基础环境搭好
  • 确认WSL里已经装了Python:打开WSL终端,输入python3 --version,如果没装就用sudo apt install python3 python3-pip完成安装
  • VSCode这边必须装两个核心插件:Python(微软官方出品的那个)和Remote - WSL。装完后点击左下角的<>图标,选择「New WSL Window」,让VSCode完全连接到WSL环境(这点很重要,别在本地窗口操作)
第二步:生成并配置Python调试文件
  • 在WSL窗口里打开你的Python项目,点击左侧的「运行和调试」图标(那个小虫子)
  • 点击「create a launch.json file」,然后选择「Python」环境,VSCode会自动生成一个基础配置
  • 把自动生成的launch.json内容替换成下面这套针对WSL的适配版本:
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: WSL 调试",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "pythonPath": "${command:python.interpreterPath}",
            "cwd": "${workspaceFolder}",
            "env": {"PYTHONUNBUFFERED": "1"},
            "justMyCode": true
        }
    ]
}
  • 关键配置说明:
    • pythonPath用${command:python.interpreterPath}会自动识别WSL里的Python解释器,不用手动写死路径
    • cwd设为${workspaceFolder},确保调试时的工作目录和你的项目根目录一致
    • console选integratedTerminal,调试输出会直接显示在VSCode的集成终端里,方便查看打印信息
第三步:验证调试功能
  • 打开要调试的Python文件,在代码行左侧点击添加断点
  • 按F5启动调试,正常情况下会命中断点,此时可以查看变量、单步执行、调用堆栈这些调试功能
常见问题排查
  • 如果提示找不到Python解释器:按Ctrl+Shift+P,输入「Python: Select Interpreter」,选择WSL环境里的Python版本
  • 如果断点没命中:检查justMyCode是否设为true,如果需要调试第三方库代码,把它改成false
  • 如果终端输出乱码:在launch.json的env里添加"LC_ALL": "en_US.UTF-8", "LANG": "en_US.UTF-8"

内容的提问来源于stack exchange,提问作者Kurosh

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.21 08:28:13