Windows 11 安装 Miniconda 与 Jupyter 全流程指南

发布于:2025-06-02 ⋅ 阅读:(27) ⋅ 点赞:(0)

一、Miniconda 安装与配置

1. 下载安装程序

  1. 访问官网​:打开 Miniconda 官网,下载 ​Python 3.x 版本的 Windows 64 位安装包​。
  2. 安装路径选择​:
    • 推荐路径:D:\Miniconda3(避免使用中文路径和空格)。

  • 勾选 ​​"Add Miniconda to my PATH environment variable"​​(简化后续命令行操作)。

安装完毕后,在环境变量里手工设置到bin目录一下才可以生效。

2. 验证安装

  1. 打开 ​Anaconda Prompt (Miniconda3)​​:
    conda --version  # 显示版本号即成功。
    

  1. 更新 Conda​(可选):
    conda update conda
    

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 --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
conda config --set show_channel_urls yes  # 显示包来源

二、虚拟环境管理

1. 创建独立环境(避免包冲突)

conda create -n jupyter_env python=3.10  # 创建名为 jupyter_env 的 Python 3.10 环境

conda env list   #查看当前的环境

conda activate jupyter_env             # 激活环境

conda deactivate jupyter_env             # 抑制环境

conda env remove --prefix="C:\Users\opfly\.conda\envs\jupyter_env" #移除环境

2. 安装 Jupyter

conda install jupyter jupyterlab       # 安装核心组件
conda install nb_conda                 # 支持内核切换(可选)

3. 环境内核绑定(使 Jupyter 识别环境)

pip install ipykernel
python -m ipykernel install --user --name=jupyter_env --display-name "Python 3.10 (Jupyter)"

三、Jupyter 优化配置

1. 修改默认启动目录

    生成配置文件:

    jupyter notebook --generate-config
    

    编辑 C:\Users\用户名\.jupyter\jupyter_notebook_config.py

    c.NotebookApp.notebook_dir = 'D:\\Jupyter_Projects'  # 替换为自定义路径
    

    2. 创建快速启动脚本

    新建 StartJupyter.bat 文件,内容:

    @echo off
    conda activate jupyter_env
    jupyter notebook

    双击运行即可自动激活环境并启动 Jupyter

    四、启动与验证

    1. 启动方式​:
      • 命令行:jupyter notebook(自动打开浏览器)
      • 界面入口:通过开始菜单的 ​Jupyter Notebook (jupyter_env)​​ 启动
    2. 验证功能​:
      • 新建 Notebook,选择内核 ​Python 3.9 (Jupyter)​
      • 输入 !conda list 检查环境依赖是否准准确

    五、常见问题解决

    1. ​Conda 命令未识别

    • 原因:环境变量未正确配置。
    • 解决:手动添加 D:\install\miniconda3\Scripts 和 D:\install\miniconda3\condabin 到系统 PATH。

    2. ​Jupyter 内核丢失

    • 原因:虚拟环境未绑定内核。
    • 解决:重新执行 ipykernel 安装命令并重启 Jupyter。

    3. ​安装包速度慢

    • 解决:临时使用清华 pip 镜像:

    pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple。

    六、扩展功能(可选)​

    1. 集成深度学习框架

    conda install pytorch torchvision torchaudio cpuonly -c pytorch  # CPU 版本 PyTorch

    2. 安装 Jupyter 插件

    conda install -c conda-forge jupyter_contrib_nbextensions  # 代码折叠、目录生成等