如何在VSCode中通过WSL安装并运行Python

云强吖_9519

云强吖_9519

2026-07-04

919人浏览

原创

vscode连接wsl后python3报错,是因为终端未真正进入wsl环境;需通过ctrl+shift+p执行remote-wsl: new window或点击左下角远程连接图标显式切换。

如何在vscode中通过wsl安装并运行python

VSCode 连接 WSL 后,python3 命令仍报错?先确认是否真在 Linux 环境里执行

很多人装完 Remote-WSL 插件就以为“连上了”,结果终端还是 PowerShellcmdpython3 --version 直接提示 command not found。这不是 Python 没装,而是 VSCode 根本没进 WSL 上下文。

必须通过以下任一方式显式进入:

  • Ctrl+Shift+P → 输入 Remote-WSL: New Window → 回车
  • 点击左下角远程连接图标(>Open Folder in WSL
  • 在已启动的 WSL 终端中,cd 到项目目录后运行 code .(前提是 Windows 版 VSCode 安装时勾选了 “Add to PATH”)

成功后,窗口左下角明确显示 WSL: Ubuntu-22.04,资源管理器路径以 wsl$Ubuntu-22.04homeusername 开头,终端提示符是 username@hostname:~$ —— 只有这时,你敲的每条命令才真正跑在 Linux 里。

项目放 /mnt/c/ 下,pip install 总失败?立刻迁移到 ~/ 原生路径

/mnt/c/ 是 Windows 文件系统(DrvFs)挂载点,不支持 Linux 权限、符号链接、inotify 事件,I/O 性能差 5–10 倍。所有开发动作放这里,必踩坑:

  • pip installPermission deniedunable to create file
  • git clone 失败,或后续 git status 显示大量文件被修改(权限位乱)
  • conda activate 后环境变量不生效,调试时找不到包

正确做法:

python全能编程助手
python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能,主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ,专为学生、算法学习者和开发者设计;✅ 一个技能,两种用途 :;核心要点📝 题解模式 :输入题目/题号,自动生成完整 Python 题解(含详细注释、解题思路、复杂度分析);💬 注释模式 :输入 Python 代码,自动添加详细中。它将相关步骤、

下载
  • 把项目根目录放在 ~/projects/myapp/home/username/src
  • 在 WSL 终端中 cd ~/projects/myapp 后再运行 code .
  • Windows 端想快速访问?资源管理器地址栏输入 wsl$Ubuntu-22.04homeusernameprojects,别反向操作

想用 conda 虚拟环境,但 VSCode 找不到?关键在 conda init 和 shell 重载

WSL 中装好 Miniconda 后,VSCode 调试器只读取 $PATH 和 shell 初始化文件(如 ~/.bashrc),但不会加载别名、函数,也不会复用 Windows 的 conda。

常见问题和解法:

  • 安装 Miniconda 时,最后一步提示 Do you wish to initialize Miniconda3? → 必须输 yes,否则 conda 命令根本不可用
  • 安装完必须关闭当前终端,重新打开一个 WSL 终端(让 ~/.bashrc 生效),再运行 conda --version 验证
  • 创建并激活环境:conda create -n myenv python=3.11conda activate myenv
  • 在 VSCode 中按 Ctrl+Shift+PPython: Select Interpreter → 从列表选 ~/miniconda3/envs/myenv/bin/python(路径要完整)

如果列表里没出现你的环境,说明 conda init bash 没成功,或没重启终端——不是插件问题,是 shell 环境没加载。

运行 Python 脚本时提示 python3 not found?检查解释器路径和 shebang 行

即使 VSCode 左下角显示了正确的 conda 环境(如 (myenv):conda),运行脚本仍可能失败,原因常被忽略:

  • 脚本第一行写了 #!/usr/bin/env python:Linux 下 python 通常指向 Python 2,而 WSL 默认只有 python3;应改为 #!/usr/bin/env python3#!/usr/bin/env python3.11
  • VSCode 的运行配置(launch.json)里指定了错误的 python 路径,比如写成 "python": "python" 而非 "python": "./.venv/bin/python"(对 venv)或完整 conda 路径
  • 终端里手动运行 python3 script.py 成功,但 VSCode 的「Run Python File」按钮失败 → 检查右下角解释器是否真的切换成功(有时显示对了,但实际没 reload)

最稳的方式:在 VSCode 终端里手动激活环境(conda activate myenv),再运行 python3 script.py。能跑通,说明环境没问题;跑不通,才是路径或权限问题。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode python

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1551

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

3684

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1569

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

21117

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2607

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2667

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1083

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

576

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2063

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程