# Windows + WSL2 + Ubuntu + Miniconda + PyCharm 开发环境搭建记录

目标：在 Windows 上使用 PyCharm + WSL2 + Ubuntu ，通过 Miniconda 创建 Python 3.11 虚拟环境 ，并让 PyCharm Terminal 自动进入该环境，用于后续后端 / AI 开发。

一、启用并安装 WSL2（Windows Subsystem for Linux）

1. 自动安装 WSL 组件

执行 WSL 相关命令后，系统会自动安装组件，日志示例：

正在下载: 适用于 Linux 的 Windows 子系统

正在安装: 适用于 Linux 的 Windows 子系统

已安装适用于 Linux 的 Windows 子系统

正在安装 Windows 可选组件: VirtualMachinePlatform

操作成功完成。直到重新启动系统前更改将不会生效。

说明：

启用了 WSL
启用了 VirtualMachinePlatform
自动安装了 WSL 核心
此阶段不会选择安装路径或发行版

2. 重启 Windows

日志提示：

直到重新启动系统前更改将不会生效

👉 必须重启后 WSL2 才会真正生效

二、安装 Ubuntu 发行版

1. 执行安装命令

bash 复制代码

wsl --install -d Ubuntu

安装过程中会看到：

正在下载: Ubuntu

正在安装: Ubuntu

已成功安装分发

正在启动 Ubuntu...

Create a default Unix user account:

表示 Ubuntu 已安装并进入初始化阶段。

2. 创建 Linux 用户

Create a default Unix user account:

建议：

使用全小写英文（如 nianan）

不建议设置为 root

接着设置密码（输入时不显示字符，属正常行为）。

初始化完成后进入：

nianan@DESKTOP-XXXX:~$

三、在 Ubuntu 中安装 Miniconda

1. 更新系统

复制代码

sudo apt update && sudo apt upgrade -y

2. 下载 Miniconda

bash 复制代码

cd ~
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

确认下载成功：

bash 复制代码

ls -lh Miniconda3-latest-Linux-x86_64.sh

执行安装

bash 复制代码

bash Miniconda3-latest-Linux-x86_64.sh

安装过程中：

协议回车翻页

bash 复制代码

Do you accept the license terms? → 输入 yes

安装路径默认即可

关键一步：

bash 复制代码

Do you wish to initialize Miniconda3 by running conda init?

→ 输入 yes

让 conda 生效

bash 复制代码

source ~/.bashrc

验证：

bash 复制代码

conda --version
which conda

四、处理 Conda TOS 提示

首次创建环境时可能提示：

bash 复制代码

CondaToSNonInteractiveError: Terms of Service have not been accepted

执行以下命令同意条款：

bash 复制代码

conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r

五、创建 Python 3.11 环境

1. 创建环境

bash 复制代码

conda create -n dev python=3.11 -y

2. 激活环境

bash 复制代码

conda activate dev

3. 验证环境

bash 复制代码

python --version
which python
conda env list

期望效果：

bash 复制代码

dev  *  /home/nianan/miniconda3/envs/dev

六、在 PyCharm 中绑定 Conda 解释器（WSL）

1. 打开解释器设置

bash 复制代码

File → Settings → Project → Python Interpreter

2. 添加解释器

点击齿轮 → Add Interpreter

选择 On WSL

选择 Ubuntu

选择 Conda Environment → Existing environment

填写路径：

Conda：

bash 复制代码

/home/nianan/miniconda3/bin/conda

Environment：

bash 复制代码

/home/nianan/miniconda3/envs/dev

点击 OK / Apply

3. 验证

bash 复制代码

which python
python --version

应为：

bash 复制代码

/home/nianan/miniconda3/envs/dev/bin/python

七、让 PyCharm Terminal 自动激活 dev 环境

修改 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

八、关于 WSL 安装位置与后续迁移说明

Ubuntu + Miniconda 默认位于 C 盘 WSL 虚拟磁盘中

后续可随时整体迁移到 D 盘（包含所有环境与项目）

迁移命令（可选）：

bash 复制代码

wsl --shutdown
wsl --export Ubuntu D:\wsl\ubuntu.tar
wsl --unregister Ubuntu
wsl --import Ubuntu D:\wsl\Ubuntu D:\wsl\ubuntu.tar

迁移属于整体搬迁，不会影响项目与环境。

九、最终环境结构总结

Windows + WSL2

Ubuntu (WSL)

Miniconda

Python 环境：

base（默认）

dev（Python 3.11，用于开发）

PyCharm：

解释器绑定 dev

Terminal 自动激活 dev