Windows WSL环境下VS Code如何切换Python 3.8解释器?
解决VS Code识别WSL Ubuntu中Python 3.8解释器的问题
先澄清一个核心误区
Linux(包括WSL Ubuntu)下的可执行文件不需要.exe后缀,从你提供的python3命令输出能明确看到,Ubuntu系统里的Python 3.8路径是/usr/bin/python3.8,这就是有效的解释器文件——不是找不到,只是和Windows的可执行文件格式规则不同。
让VS Code识别该解释器的具体方法
方法1:通过命令面板手动选择
- 确保VS Code已安装并启用WSL扩展(没装的话直接在扩展市场搜"WSL"安装)。
- 按下
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac)打开命令面板。 - 输入并选择
Python: Select Interpreter。 - 在弹出的列表里,找带
WSL: Ubuntu前缀的选项,里面会列出/usr/bin/python3.8,直接选中即可。- 如果列表没显示,点击
Enter interpreter path,手动输入/usr/bin/python3.8后确认。
- 如果列表没显示,点击
方法2:通过settings.json配置指定
- 按下
Ctrl+,(Windows/Linux)或Cmd+,(Mac)打开VS Code设置。 - 点击右上角的
打开设置(JSON)图标({}形状)。 - 在settings.json中添加以下配置(已有
python.defaultInterpreterPath则替换为对应路径):"python.defaultInterpreterPath": "/usr/bin/python3.8", "python.terminal.activateEnvironment": true, "remote.WSL.defaultDistribution": "Ubuntu" - 保存配置后重启VS Code生效。
方法3:切换到WSL工作区操作
- 打开命令面板,输入
Remote-WSL: New Window,打开连接到WSL Ubuntu的新窗口。 - 在这个窗口中打开你的项目文件夹,VS Code会自动识别WSL内的Python解释器,再通过
Python: Select Interpreter选择python3.8即可。
验证配置是否生效
- 确认VS Code终端是WSL Ubuntu环境(左侧会显示
WSL: Ubuntu)。 - 输入
python3.8 --version,确认输出为Python 3.8.x版本。 - 编写
import pandas as pd测试代码,此时导入语句的下划线会消失,代码可正常运行。
内容的提问来源于stack exchange,提问作者Waterfall
相关产品推荐
相关产品推荐

