跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

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

Windows 系统下 WSL2 结合 Ubuntu 发行版构建 Python 开发环境,通过 Miniconda 管理 Python 3.11 虚拟环境,并集成 PyCharm 进行解释器绑定与终端自动激活。步骤包括启用 WSL 组件、安装 Ubuntu、部署 Miniconda、处理 Conda 协议、创建开发环境,以及配置 PyCharm 连接 WSL 解释器和修改终端 Shell Path,确保开发工具链无缝协作。

beaabea发布于 2026/2/26更新于 2026/10/26107 浏览

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

3. 执行安装

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

4. 让 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

目录

  1. Windows + WSL2 + Ubuntu + Miniconda + PyCharm 开发环境搭建
  2. 一、启用并安装 WSL2(Windows Subsystem for Linux)
  3. 1. 自动安装 WSL 组件
  4. 2. 重启 Windows
  5. 二、安装 Ubuntu 发行版
  6. 1. 执行安装命令
  7. 2. 创建 Linux 用户
  8. 三、在 Ubuntu 中安装 Miniconda
  9. 1. 更新系统
  10. 2. 下载 Miniconda
  11. 3. 执行安装
  12. 4. 让 conda 生效
  13. 四、处理 Conda TOS 提示
  14. 五、创建 Python 3.11 环境
  15. 1. 创建环境
  16. 2. 激活环境
  17. 3. 验证环境
  18. 六、在 PyCharm 中绑定 Conda 解释器(WSL)
  19. 1. 打开解释器设置
  20. 2. 添加解释器
  21. 3. 验证
  22. 七、让 PyCharm Terminal 自动激活 dev 环境
  23. 八、关于 WSL 安装位置与后续迁移说明
  24. 九、最终环境结构总结

更多推荐文章

查看全部
  • 人工智能对上位机系统的全面重塑与影响分析
  • OpenClaw 入门:本地 AI 助手架构、功能与使用场景
  • OpenCode:开源免费的 AI 编程智能体介绍
  • 使用 Java 和 Python 发送消息至飞书自定义机器人
  • 英伟达 GTC 2025 医疗健康与生命科学会议要点解析
  • Flume架构深度解析:构建高可用大数据采集系统
  • OpenClaw 在 Linux 上接入本地 Ollama 的配置记录
  • 扩散模型(Diffusion Model)原理与图像生成实战
  • GESP C++ 二级认证真题与解析(单选题 1-15)
  • Midjourney 进阶:色相详解与色彩控制
  • AI 时代产品经理成长指南
  • C++ 继承机制详解:从基础语法到多态应用
  • Claude Code 在 Linux(Ubuntu) 上的安装部署指南
  • AI 产品经理职业发展前景与核心能力解析
  • CCF-CV 企业交流会:AI 安全治理与可信未来探讨
  • AI 产品经理成长指南:核心能力与技能路径
  • 如何在 GitHub 或 GitLab 上删除远程文件夹
  • Java 智能体开发:3 个常见误区与正确学习路径
  • AI 编程:自动化代码生成、低代码与无代码开发、算法优化实践
  • 拆解 DDSM400 钕强磁外转子 65mm 伺服轮毂电机

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online