VSCode搭配WSL时运行按钮无法识别/mnt路径，代码无法运行

AI 小北

2026-8-17

解决VSCode在WSL Ubuntu中运行Python文件路径不兼容问题

以下是几种可行的解决方案，按优先级排序：

1. 确认VSCode已正确连接到WSL环境

查看VSCode左下角状态栏，确保显示WSL: Ubuntu（或你的WSL发行版名称）。如果显示的是Windows环境，点击该标识，选择Connect to WSL重新建立连接。只有在WSL远程会话中，VSCode才会自动处理路径转换。

2. 配置Code Runner插件适配WSL

如果你使用的是Code Runner插件（默认快捷键Ctrl+Alt+N），调整以下设置：

打开VSCode设置（Ctrl+,），搜索Code Runner: Executor Map，编辑Python对应的命令，改为：
```
"python": "python3 -u $fullFileName"
```
在WSL连接状态下，$fullFileName会自动转换为WSL格式的路径（如/mnt/c/Users/...）。
勾选Code Runner: Run In Terminal选项，让命令在WSL集成终端中执行，避免路径解析错误。
勾选Code Runner: File Directory As Cwd，确保运行时的工作目录为文件所在的WSL路径。

3. 设置Python解释器为WSL版本

打开VSCode设置，搜索Python: Default Interpreter Path，设置为WSL中的Python路径，比如/usr/bin/python3或你的虚拟环境路径（如~/venv/bin/python）。
也可以通过左下角状态栏的Python解释器选择器，直接选择WSL中的Python版本。

4. 自定义launch.json运行配置

如果上述方法无效，创建专属的WSL运行配置：

打开运行和调试面板（Ctrl+Shift+D），点击创建launch.json文件，选择Python环境。

替换生成的配置内容为：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: WSL",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "pythonPath": "/usr/bin/python3"
        }
    ]
}