欢迎光临
我们一直在努力

# 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. 执行安装命令

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

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? → 输入 yes

    安装路径默认即可

    关键一步:

    Do you wish to initialize Miniconda3 by running conda init?

    → 输入 yes

  • 让 conda 生效
  • source ~/.bashrc

    验证:

    conda –version
    which conda

    四、处理 Conda TOS 提示

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

    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

    五、创建 Python 3.11 环境

    1. 创建环境

    conda create -n dev python=3.11 -y

    2. 激活环境

    conda activate dev

    3. 验证环境

    python –version
    which python
    conda env list

    期望效果:

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

    六、在 PyCharm 中绑定 Conda 解释器(WSL)

    1. 打开解释器设置

    File → Settings → Project → Python Interpreter

    2. 添加解释器

    点击齿轮 → Add Interpreter

    选择 On WSL

    选择 Ubuntu

    选择 Conda Environment → Existing environment

    填写路径:

    Conda:

    /home/nianan/miniconda3/bin/conda

    Environment:

    /home/nianan/miniconda3/envs/dev

    点击 OK / Apply

    3. 验证

    which python
    python –version

    应为:

    /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 盘(包含所有环境与项目)

    迁移命令(可选):

    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

    赞(0)
    未经允许不得转载:171主机测评 » # Windows + WSL2 + Ubuntu + Miniconda + PyCharm 开发环境搭建记录
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址