Windows + WSL2 + Ubuntu + Miniconda + PyCharm 开发环境搭建
目标:在 Windows 上使用 PyCharm + WSL2 + Ubuntu,通过 Miniconda 创建 Python 3.11 虚拟环境,并让 PyCharm Terminal 自动进入该环境,用于后续后端 / AI 开发。
Windows 系统下 WSL2 结合 Ubuntu 发行版构建 Python 开发环境,通过 Miniconda 管理 Python 3.11 虚拟环境,并集成 PyCharm 进行解释器绑定与终端自动激活。步骤包括启用 WSL 组件、安装 Ubuntu、部署 Miniconda、处理 Conda 协议、创建开发环境,以及配置 PyCharm 连接 WSL 解释器和修改终端 Shell Path,确保开发工具链无缝协作。
目标:在 Windows 上使用 PyCharm + WSL2 + Ubuntu,通过 Miniconda 创建 Python 3.11 虚拟环境,并让 PyCharm Terminal 自动进入该环境,用于后续后端 / AI 开发。
执行 WSL 相关命令后,系统会自动安装组件,日志示例:
正在下载:适用于 Linux 的 Windows 子系统
正在安装:适用于 Linux 的 Windows 子系统
已安装 适用于 Linux 的 Windows 子系统
正在安装 Windows 可选组件:VirtualMachinePlatform
操作成功完成。直到重新启动系统前更改将不会生效。
说明:
WSLVirtualMachinePlatform日志提示:直到重新启动系统前更改将不会生效。 👉 必须重启后 WSL2 才会真正生效。
wsl --install-d Ubuntu
安装过程中会看到:
正在下载:Ubuntu
正在安装:Ubuntu
已成功安装分发
正在启动 Ubuntu…
Create a default Unix user account:
表示 Ubuntu 已安装并进入初始化阶段。
Create a default Unix user account:
建议:
nianan@DESKTOP-XXXX:~$
sudo apt update && sudo apt upgrade -y
cd ~
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
确认下载成功:
ls -lh Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh
安装过程中:
Do you accept the license terms? → 输入 yesDo you wish to initialize Miniconda3 by running conda init? → 输入 yessource ~/.bashrc
验证:
conda --version
which conda
首次创建环境时可能提示:
CondaToSNonInteractiveError: Terms of Service have not been accepted
执行以下命令同意条款:
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r
conda create -n dev python=3.11 -y
conda activate dev
python --version
which python
conda env list
期望效果:
dev * /home/nianan/miniconda3/envs/dev
File → Settings → Project → Python Interpreter
点击齿轮 → Add Interpreter。 选择 On WSL → 选择 Ubuntu → 选择 Conda Environment → Existing environment。 填写路径:
/home/nianan/miniconda3/bin/conda/home/nianan/miniconda3/envs/dev
点击 OK / Apply。which python
python --version
应为:
/home/nianan/miniconda3/envs/dev/bin/python
修改 Terminal Shell Path:Settings → Tools → Terminal。
将 Shell path 修改为:
/bin/bash -lc "conda activate dev && exec bash"
作用:仅 PyCharm Terminal 自动进入 dev,不影响系统其它终端。
验证:
conda env list
which python
python --version
Ubuntu + Miniconda 默认位于 C 盘 WSL 虚拟磁盘中。 后续可随时整体迁移到 D 盘(包含所有环境与项目)。 迁移命令(可选):
wsl --shutdown
wsl --export Ubuntu D:\wsl\ubuntu.tar
wsl --unregister Ubuntu
wsl --import Ubuntu D:\wsl\Ubuntu D:\wsl\ubuntu.tar
迁移属于整体搬迁,不会影响项目与环境。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online