WSL2 Ubuntu环境下VSCode调试Python时launch.json args参数不生效问题

1. 确认调试配置选中状态 #

• 点击VSCode左侧运行和调试面板顶部的下拉框，确认当前选中的配置为你编写的Python: Debug，而非默认无参数的Python启动项

2. 修正launch.json格式错误 #

你提供的配置存在JSON尾逗号问题，部分解析器会因格式错误无法正常加载配置，同时建议补充program字段指定调试文件路径，修正后的配置参考：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Debug",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "args": ["--name", "Marco"]
        }
    ]
}

3. 确认WSL远程环境状态 #

• 检查VSCode左下角状态栏，确认显示WSL: Ubuntu字样，处于WSL远程窗口状态，而非本地Windows窗口打开WSL路径下的项目
• 打开扩展面板搜索Python插件，确认插件已对WSL环境启用，并非仅在本地Windows安装

4. 确认启动方式匹配规则 #

launch.json的配置仅对通过运行和调试面板点击启动按钮、按F5启动的调试进程生效；如果通过右键菜单运行Python文件、Code Runner插件启动，不会读取launch.json的参数配置，需要单独对应配置启动参数。

5. 问题排查验证 #

可在main.py开头添加参数打印代码，确认参数传入状态：

import sys
print(sys.argv)

如果打印结果包含--name和Marco，说明参数已正常传入，问题出在业务代码逻辑；如果无对应参数，可重新执行上述排查步骤，或按Ctrl+Shift+P调出命令面板，执行Python: Select Interpreter手动选择WSL环境下的Python解释器后重启调试。

内容的提问来源于stack exchange，提问作者Mameli Marco