如何配置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
相关产品推荐
相关产品推荐

