先说个结论:标题里说的这件事,是目前在 Windows 上做 Python 开发最值得花半小时搞定的基础配置。WSL 里跑 Conda,再用 Conda 建 Python 环境,好处不只是“能跑”,而是把你从 Windows 和 Linux 两套工具链来回切换的混乱里彻底解放出来。你在 Windows 侧看着 WSL 里的 Python 脚本在跑,但文件、依赖、环境变量全都在一个干净的 Linux 隔离空间里,不会和系统里乱七八糟的 Python 打架,也不会因为装了个包把整个系统搞坏。
这篇文章就是一份完整的实操记录,覆盖了下载安装 Miniconda、用 Conda 创建带指定 Python 版本的虚拟环境、配置 pip、处理国内下载慢的问题,还有我自己踩过的几个坑。适合刚接触 WSL 的同学,也适合在 Windows 上开发但一直觉得环境乱、想重新整理一遍的人。你会看到我为什么选这套方案、每一步在做什么、出了错怎么排查。
1. 整体思路与方案决策:先想清楚为什么要在 WSL 里折腾环境
1.1 为什么选 WSL + Conda,而不是直接在 Windows 里装 Python
很多人在 Windows 上直接下载安装 Anaconda,然后用 conda 建环境,这么做不是不能用,但遇到真实项目会越来越别扭。典型的问题有几个:一是 Windows 版 Python 和某些带 C 扩展的库兼容性差,像是 psycopg2、pydantic、numpy 这类需要编译的包,经常装的时候报“Microsoft Visual C++ 14.0 is required”;二是团队部署多半是 Linux 服务器,你在 Windows 上开发完,代码一上服务器就各种环境差异,明明本地能跑一到 Linux 就崩溃。
WSL 的语义是把 Linux 环境“塞”进 Windows,不需要装双系统,也不需要开虚拟机,直接通过终端模拟出一个几乎原生的 Linux 用户态。开发时你在 WSL 里用的 Python 和依赖,和服务器上用的是同一套体系,编译行为、文件权限、路径规则都一致。再把 Conda 放进去管理 Python 版本,等于同时解决了“跨平台一致性”和“多项目的依赖隔离”两个最头疼的问题。
1.2 Python 环境放到哪个层级,决定了你后续会不会踩坑
这里先说清楚一个层级关系。WSL 是底层系统,Conda 是运行在 WSL 里的包管理与环境管理工具,Python 是 Conda 管理下的运行时。你不要直接去 WSL 的 Ubuntu 系统目录里手动装 Python,也不要用 apt install python3 装一大堆包。正确的姿势是:系统层面保持干净,所有 Python 版本和依赖都收在 Conda 的 envs 目录里。
我见过不少人在 WSL 里先用 apt 装了 python3-pip,之后又装了 Miniconda,两种 pip 互相覆盖,最后 terminal 里敲 pip 指向的是 /usr/bin/pip,敲 python 指向的却是 conda 的 Python,两个 pip 指向不同解释器,装完包以后 import 直接失败。排查这种问题非常浪费时间。最好的方案就是从一开始就不碰系统 Python,把系统 Python 交给系统服务去用,项目里的 Python 全走 conda env。
1.3 安装目录选择:不要把 Conda 环境放到 /mnt/c 下面
这是我在实操中踩过最深的一个坑。WSL 通过 /mnt/c 访问 Windows 的 C 盘目录,如果你的 Home 目录在挂载的 Windows 路径下,或者你把 Miniconda 安装到 /mnt/c/xxx,文件访问性能会有很明显的损耗,尤其是安装大量小文件包的时候,速度慢得像是卡住了一样。
Conda 环境一旦创建,会有大量小文件,python 的 site-packages 目录里有几百上千个文件。如果整个环境放在 Windows 文件系统里,每次激活环境读 py 文件、导入模块、写字节码缓存都会跨文件系统读写,性能能差数倍。所以我的建议一直是:Miniconda 装到 WSL 的 Linux 文件系统里,也就是默认的 ~/miniconda3,环境也默认放在 /home/用户名/miniconda3/envs 下。Windows 侧的代码可以用软链接或者复制的方式放进去,但环境本体不要跨盘放。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 部署实操:从 WSL 到 Miniconda 的完整安装记录
2.1 先确认 WSL 基本可用
如果你的 WSL 已经装好,可以跳过这步。如果还没装,在管理员 PowerShell 里跑:
powershell复制wsl --install
这条命令会安装 WSL 2 内核并默认安装 Ubuntu。执行完成之后按要求重启系统,然后从开始菜单打开 Ubuntu 终端完成账户和密码设置。
需要注意一点:如果在这条命令执行过程中特别慢,或者提示服务无法启动,通常先不要急着重装,可以检查两个地方。第一,看 BIOS 里是否开启了虚拟化;第二,运行 wsl --update 确认内核是最新的,老内核可能导致某些版本的 Ubuntu 无法启动或者访问文件异常。
如果装的时候不幸卡在“正在安装”不动,可以直接去应用商店搜 Ubuntu,手动安装对应版本,然后运行一次初始化。WSL 底层装好之后,在终端里敲 wsl -l -v 看到下面这样的输出就说明基本环境没问题:
text复制 NAME STATE VERSION
* Ubuntu Running 2
这个输出里必须确认 VERSION 那列是 2,如果显示的是 1,跑一下 wsl --set-version Ubuntu 2 做转换。WSL 1 和 WSL 2 的文件系统行为差异很大,后面跑 Conda 装包会有不少莫名其妙的坑。
2.2 下载 Miniconda:用国内镜像源解决慢的问题
进入 WSL 的 Ubuntu 终端后,不要直接用官网的 repo.anaconda.com 下载。国内网络环境下这个源时快时慢,断断续续下到一半然后报错是很常见的事。
直接使用清华的 Anaconda 镜像来下 Miniconda 安装脚本:
bash复制cd ~
wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-py311_24.7.1-0-Linux-x86_64.sh
如果没有安装 wget,用 curl 也行:
bash复制curl -L https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-py311_24.7.1-0-Linux-x86_64.sh -o Miniconda3.sh
文件名里的 py311 表示安装脚本默认带的 Python 版本是 3.11。这里需要解释一个容易混淆的点:Miniconda 自带的这个 Python 只是用于跑 conda 命令的基础环境,你之后用 conda create 可以创建任意 Python 版本的独立环境,所以不用纠结下载的版本是 3.11 还是 3.10。
下载之后顺手校验一下文件大小,如果只有几百字节,大多是网络出问题下到了错误页面,需要重新下载。
还有一种情况是终端里 wget、curl 都因为网络原因下载失败,备用方案是用 Windows 浏览器手动下载安装脚本,然后通过 Windows 路径复制到 WSL 里:
bash复制cp /mnt/c/Users/你的用户名/Downloads/Miniconda3.sh ~/
我个人不推荐这种手动方式,但作为兜底方法是有效的。需要注意:不要让安装脚本直接运行在 /mnt/c 下的位置,复制到 ~ 目录再执行。
2.3 执行安装脚本并完成初始化
在 ~ 目录下执行:
bash复制bash Miniconda3.sh
安装过程会连续询问几个问题:
- License 协议:按回车浏览到最底部,输入
yes接受。 - 安装路径:直接回车使用默认的
/home/用户名/miniconda3,不需要修改。 - 是否运行 conda init:这里一定要输入
yes,否则 shell 不会自动加载 conda 命令,之后每次都要手动 source 会很麻烦。
安装结束后,重新打开终端,或者执行 source ~/.bashrc。这时提示符前缀会出现 (base),说明 conda 的默认 base 环境已经被激活了。运行 conda --version 能正常显示版本号就代表安装成功:
text复制conda 24.7.1
如果你重新打开终端后没有看到 (base),不要急着去修改 PATH。先检查 ~/.bashrc 末尾有没有 conda 初始化的相关代码,或者手动执行一次:
bash复制source ~/miniconda3/etc/profile.d/conda.sh
conda activate base
要注意一点:WSL 默认登录 shell 可能是 dash 而不是 bash,有些精简过的系统会出这种问题。执行 echo $SHELL 确认输出是 /bin/bash,如果不是,用 chsh -s /bin/bash 切换一下。
3. 配置国内镜像源:conda 和 pip 必须分开处理
3.1 conda 本身的换源操作
Conda 创建环境时默认会去官方的 repo.anaconda.com 下载 Python 解释器和基础包,国内网络经常超时。即使你已经用清华镜像下载了 Miniconda 安装包,conda 安装后的默认软件源依然是官方源,这两个环节互不相干,需要单独配置。
一次配置到位的方法是在 WSL 终端里逐条执行:
bash复制conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --set show_channel_urls yes
执行完后,~/.condarc 文件里的 channels 列表会是一条一条记录,最上面的是刚添加的。需要注意:conda config --add 是往列表头部添加,所以如果你想控制渠道优先级,添加顺序要注意。一般只要配了 main、free、conda-forge 就够日常使用了,不需要把 bioconda 之类的也加进去,源多了反而会让依赖解析变慢。
3.2 pip 的源是独立的,别以为 conda 换完源 pip 就快了
这是热词里暴露出来最多的一个误区。很多人配完了 conda 源,创建环境后执行 pip install xxx,发现速度依然只有几十 KB/s,就开始质疑是不是源没配好。实际上 conda 的镜像配置跟 pip 没有任何关系。
如果你在 Conda 创建的环境里用 pip 装包,pip 默认读的还是 pypi.org 官方源。所以在进入 Conda 环境后,需要单独设置 pip 的全局源:
bash复制mkdir -p ~/.pip
cat > ~/.pip/pip.conf <<EOF
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF
也可以不用手动创建配置文件,直接用 pip 自带的 config 命令:
bash复制pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set 会把配置写到 ~/.config/pip/pip.conf,效果是一样的。我推荐默认用第一种手动写 ~/.pip/pip.conf 的方法,因为这套配置对系统 pip 和 conda 环境内所有 pip 都生效,不需要每个环境单独设置。
3.3 验证源有没有真正生效
配置完不要直接开始装包,先验证一下当前源,否则后面出了问题都不知道根源在哪。
验证 conda 源:
bash复制conda config --show channels
如果输出的 channel URLs 里有 tuna 镜像,说明配置成功。接着跑一个依赖解析命令,比如 conda update --all,观察输出的下载 URL 是否来自 mirrors.tuna.tsinghua.edu.cn/anaconda。
验证 pip 源:
bash复制pip config list
或者在安装一个包的时候加 -v 参数,例如:
bash复制pip install requests -v
看日志里 Looking in indexes 这一行显示的是不是清华镜像地址。如果显示的还是 pypi.org/simple,说明 pip 配置没被读到,检查一下是否把配置文件写错了目录,或者环境变量里有没有 PIP_INDEX_URL 覆盖了配置文件。
4. Conda 创建 Python 环境:指定版本、激活与 pip 双确认
4.1 用 conda create 创建虚拟环境
环境配置好后,创建环境这一步就非常简单了。下面这条命令创建一个名为 mlenv 的环境,并指定 Python 版本为 3.10:
bash复制conda create -n mlenv python=3.10 -y
这里解释一下命令背后的逻辑。-n 后面的名字你可以随意取,但建议和项目语义对应,不要叫 test 或者 new 这种没有信息量的名字。python=3.10 的意思是让 conda 根据这个约束条件去解析依赖,找到兼容的 Python 版本并安装。如果你项目里有些包还没有适配新版,直接用这个版本约束就能解决。
当你看到终端里出现 Proceed ([y]/n)?,按 y 回车,conda 会显示一系列即将安装的包列表。包括 Python 解释器、pip、setuptools、wheel 等基础工具。下载完会执行链接操作,正常情况下整个过程在一两分钟内结束。
如果创建过程中报 CondaHTTPError: HTTP 000 CONNECTION FAILED,不用怀疑,就是网络源没有配好,回到上一节逐个检查 conda 源配置项即可。
4.2 环境激活后,如何确认 python 和 pip 指向正确位置
创建完成后,激活环境:
bash复制conda activate mlenv
终端提示符会变成 (mlenv) 用户名@主机名:路径。这一步并不代表你现在用的 Python 就是环境里的 Python,尤其是你在系统里曾经用 apt 装过 Python,或者之前手动编译过 Python,有可能 python 命令依然指向系统路径。
所以进入环境后,第一件事是执行这两个命令:
bash复制which python
which pip
正确的结果应该类似:
text复制/home/用户名/miniconda3/envs/mlenv/bin/python
/home/用户名/miniconda3/envs/mlenv/bin/pip
只要看到路径里有 envs/mlenv,就说明当前 shell 里的 python 和 pip 都指向这个新的 Conda 环境。如果输出的是 /usr/bin/python,说明 conda 环境激活了但 PATH 优先级没生效,手动检查一下 echo $PATH 开头是不是 conda 的 envs 路径。
再执行这两条命令确认版本信息:
bash复制python --version
pip --version
看到 Python 版本是 3.10.x,pip 版本下方带括号标注了当前环境路径,两个都确认完再进入下一步装包。磨刀不误砍柴工,这个“双确认”步骤帮我避免了九成以上的环境错乱问题。
4.3 用 pip 安装两个示例包走通完整流程
为了验证整个链路,我习惯在新环境里装两个最常用的包,一个纯 Python 库,一个带 C 扩展的库:
bash复制pip install requests
pip install numpy
如果镜像源配置生效,下载速度会非常快。装完以后查看环境内包列表:
bash复制pip list
conda list
你会看到 requests、numpy 都在列表里。这里有个实际经验需要分享:pip list 和 conda list 都能列出包,但两者管理机制不同。conda list 只显示 conda 安装的和能识别的包,pip list 则列全部通过 pip 安装的包。如果你之前用 pip 往当前环境装了很多包,那么 conda list 里可能显示不全,这是正常的,不代表包丢失。
最后用一个简单的导入测试收尾:
bash复制python -c "import requests, numpy; print(requests.__version__, numpy.__version__)"
能正常输出版本号,就说明 WSL 下 Conda 创建 Python 环境、下载 pip、通过 pip 安装依赖的完整流程已经全线跑通。
5. 日常使用中的关键抉择与排查经验
5.1 Conda install 和 pip install 到底怎么选
这个问题在热词里关注度最高,也是新手最容易摇摆的地方。我的实际用法是一个简单原则:conda 有的包尽量用 conda 装,conda 装不了的再考虑 pip。
为什么这么定?Conda 不仅管 Python 包,还会管 Python 之外的二进制依赖,比如 numpy 依赖的 BLAS 库、pandas 依赖的底层 C 库。Conda 在安装时会自动处理这些依赖的版本匹配,而 pip 只负责 Python 包层面的依赖,不会帮你检查系统库是否兼容。如果混用不当,可能出现“pip 装了一个新版本 numpy,覆盖了 conda 管理的旧版本 numpy,而某个 conda 装的包是基于旧版本编译的”这种情况,虽然通常不至于跑不起来,但排查起来非常折磨。
| 场景 | 建议工具 | 原因 |
|---|---|---|
| 安装 numpy、pandas、scipy 等科学计算包 | conda | 依赖的底层库被 conda 统一管理,二进制兼容性好 |
| 安装 requests、flask、django 等纯 Python 包 | conda 或 pip 均可 | 依赖简单,两个工具都能处理 |
| 安装 github 上发布的最新版本包 | pip | conda 上的版本通常滞后,pip 可直接安装最新发布 |
| 安装不在 conda 仓库的包 | pip | conda search 不到只能走 pip |
| 项目有 requirements.txt | pip | 文件里的包名和版本约定就是面向 pip 的 |
实际操作里还有一个高频操作:pip 报 externally-managed-environment 错误。这是因为较新的 Python 版本启动了对系统包管理的保护机制,提示你当前环境是系统管理的,不应该直接 pip install。Conda 创建的环境不会有这个提示,反而会更顺畅。
5.2 典型问题排查速查表
在 WSL 下用 Conda 配环境,我把常遇到的问题整理成了一份速查表,每个都是实际遇到过或者被问过很多次的。
| 现象 | 根因 | 处理方法 |
|---|---|---|
| 打开终端没有出现 (base) | conda init 没有正确写入 .bashrc | 手动执行 source ~/miniconda3/etc/profile.d/conda.sh |
| 提示 conda 命令找不到 | PATH 没包含 miniconda3/bin | 检查 export PATH="$HOME/miniconda3/bin:$PATH" 是否在 .bashrc 里 |
| conda create 报 HTTP 000 | conda 镜像源没生效 | 执行 conda config --show channels 检查配置 |
| pip 安装速度慢 | 只配了 conda 源,没配 pip 源 | 配置 ~/.pip/pip.conf |
| python 和 pip 指向不一致 | PATH 里有多个 Python | 在激活环境后用 which python、which pip 确认 |
| WSL 里 import 到的包和 Windows 里看到的不同 | Windows 侧 Python 与 WSL 的 Python 完全是两套环境 | 所有 Python 操作统一在 WSL 内完成 |
| 环境里装包总报 PermissionError | 安装目录权限问题 | 检查 miniconda3 目录 owner:ls -ld ~/miniconda3 |
| 跑深度学习模型时找不到 GPU | WSL 里没有安装 Windows GPU 驱动的 Linux 版本 | 在 Windows 侧更新最新驱动,WSL 内执行 nvidia-smi 验证 |
这里面最容易被忽略的是最后一条。很多人在 WSL 里装好了 PyTorch,执行代码却提示 CUDA not available,就开始怀疑 conda 环境。其实 WSL 使用 GPU 依赖 Windows 侧的 NVIDIA 驱动,不是 WSL 里的 Ubuntu 自己装驱动。你只要在 Windows 侧把驱动更新到最新版本,然后在 WSL 终端验证一下:
bash复制nvidia-smi
能看到显卡信息就说明 GPU 在 WSL 里可用了。这个验证做完,后面再装 PyTorch 的 CUDA 版本就不会走弯路。
5.3 环境搞坏了?直接删掉重建是最优解
Conda 环境最让人安心的地方就是“重建成本极低”。我见过一些同学在环境里遇到依赖冲突,花一个多小时手动降级这个包、升级那个包,最后环境变得不可复用。其实 Conda 环境本身是廉价的,删除重建才是正确姿势。
查询现有环境:
bash复制conda env list
删除出问题的环境:
bash复制conda remove -n mlenv --all
然后重新用原来的命令创建:
bash复制conda create -n mlenv python=3.10 -y
因为我前面建议在“环境内”只装项目必需的包,所以重建后只需要按顺序装一遍依赖即可。这也是为什么尽量不要往全局 base 环境里装各种项目包,保持 base 干净,项目环境轻量,出问题后几分钟就能恢复。
把环境建好之后,我的建议是不管你接下来做 Django Web 开发、写数据脚本,还是跑机器学习,都先花一点时间把 WSL、Conda、pip 这套基础链路彻底理顺。我早期总觉得环境问题靠搜索解决就行,后来发现真正节省时间的不是搜索得快,而是环境模型从一开始就清晰:WSL 管系统,Conda 管 Python,pip 管 Python 包,三者各司其职,谁的问题找谁,思路完全不会乱。
根据我个人的实操体会,最后再补一个很小的技巧:在 ~/.bashrc 里加一行 conda deactivate,可以让终端启动时默认不激活 base 环境,避免每次打开终端都要手动退出 base,也不会因为 base 环境干扰到项目环境的判断。环境干净了,后面出问题的概率会少很多。
