Miniconda+Jupyter+PyCharm初始环境配置

如何用轻量化的 Miniconda + Jupyter + PyCharm 配置隔离性强、便于管理的 Python 开发环境? 为了做深度学习我一开始配置环境也一头雾水, 现在就将我的经验分享给大家(我是windows系统),有什么问题请尽量指正,谢谢!

一、为什么用 Miniconda，而不是 Anaconda？

很多刚接触 Python 的同学可能听过 Anaconda，它是一个集大成的 PyData 发行版，包含上千个包，一键安装，非常方便。

但它也有两个致命缺点：

• 安装包庞大（> 3GB）
• 默认安装冗余包（用不到）

Miniconda 更轻，更灵活：

📌 所以：推荐使用 Miniconda + 手动配置环境，更专业、更稳定！

二、Miniconda 基础环境配置步骤

1.下载 Miniconda

前往官网下载（注意匹配系统和 Python 版本）：

🔗 Miniconda官方镜像

建议使用 Python 3.10 或 3.11 版本（二者与主流依赖兼容性好）：

# 选择如下其中一个版本安装：
Miniconda3-latest-Linux-x86_64.sh
Miniconda3-latest-Windows-x86_64.exe

2.安装与配置路径（以 Linux/macOS 为例）

bash Miniconda3-latest-Linux-x86_64.sh

然后执行如下命令让 conda 生效：

source ~/.bashrc

或者你用 zsh：

source ~/.zshrc

3.切换清华源（加快加载包的速度）

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
conda config --set show_channel_urls yes

三、Jupyter Notebooks 安装与配置（base环境 + kernel切换）

推荐安装策略：把 Jupyter 安装在 base 环境，代码运行在虚拟环境

安装 Jupyter + nb_conda_kernels（供 kernel 切换）

conda activate base
conda install jupyter notebook nb_conda_kernels -y

这样 Jupyter 就安装在 base 环境，但可以识别所有 Conda 虚拟环境。

创建项目用的环境

conda create -n dl_env python=3.10 numpy matplotlib pandas pytorch torchvision cudatoolkit=11.7 -c pytorch -y
conda activate dl_env

# 安装 ipykernel 用于注册 kernel
pip install ipykernel
python -m ipykernel install --user --name dl_env --display-name "Python (dl_env)"

这样，启动 Jupyter Notebook 时可以选择 Python (dl_env) kernel，虽然实际服务是 base 启动的，但运行代码的解释器是项目环境

示例 Jupyter 启动说明图（浏览器页面）

Kernel 列表示：

+ Python (base)
+ Python (dl_env)
+ Python (nlp_env)

点击选择对应的就可以在不同的 conda 环境中运行 notebook 了。

四、PyCharm 配置使用 Miniconda 和 Jupyter

1. 配置 Conda 解释器

• 打开 PyCharm > Preferences > Project: xxx > Python Interpreter
• 点击右上角⚙️ > Add
• 选择 Conda Environment
  • Existing environment
  • 选择 ~/miniconda3/envs/xxx/bin/python

建议按照项目使用虚拟环境，比如：

2. 配置 Jupyter Notebook 在 PyCharm 中使用

1. 打开 .ipynb 文件，顶部出现 Jupyter 工具栏
2. 设置解释器：选择你为该项目注册的 kernel（如 “dl_env”）进行运行
3. 即可在 PyCharm 内部运行 Jupyter 项目代码

即使 PyCharm 显示当前解释器是 base，也能用项目 kernel 执行代码，避免冲突！

常见问题汇总

五、一键脚本：快速打造 Conda + Jupyter 项目环境

#!/bin/bash
echo "√ 创建 Conda 虚拟环境并注册为 Jupyter Kernel"

ENV_NAME=$1

if [ -z "$ENV_NAME" ]; then
  echo "× 请提供环境名： 例如 init_env.sh myenv"
  exit 1
fi

conda create -n $ENV_NAME python=3.10 -y
conda activate $ENV_NAME
pip install ipykernel
python -m ipykernel install --user --name $ENV_NAME --display-name "Python ($ENV_NAME)"
echo "环境 $ENV_NAME 已准备就绪并注册到 Jupyter"

使用方式：

bash init_env.sh dl_env

六、最佳实践总结

That’s all, thanks for reading!
觉得有用就点个赞、收进收藏夹吧！关注我，获取更多干货～