代码收藏家技术教程 2024-10-02

Miniconda与Jupyter保姆式安装指南：从零开始优雅设置

1. 安装miniconda

2. 检查envs和pkg位置

拓展：conda 基础操作

3. pip 和 conda 换源 (清华源)

4. 安装Jupyter

5. 虚拟环境接入Jupyter

6. 优雅地启动Jupyter

可能遇到的问题：jupyter未添加到环境变量

7. 拓展：本地pip安装“包”

本文主要参考：如何优雅地使用miniconda | 安装,envs_dirs,换源,优雅地打开Jupyter_哔哩哔哩_bilibili

本人亲自上手实操，堪称最佳实践，亲测特别优雅，elegant！！！

1. 安装miniconda

miniconda 官网: https://docs.conda.io/projects/miniconda/en/latest/

咱装最新版！没有问题！

添加到环境变量很关键，可以省去很多麻烦

得装在D盘（虚拟环境很费空间），创建一个空文件夹，选择路径后开始安装

2. 检查envs和pkg位置

win+s 搜索“anaconda prompt” 打开文件位置

两个都可以用，但一般选第二个

打开 “Anaconda Prompt (miniconda3)”

Miniconda base 环境自带最新python

输入“conda info” 看看默认位置

package cache：这是Conda存储下载的包的地方。

envs：这是Conda用于存储不同虚拟环境的地方。

多行地址的顺序：一般优先第一个，D盘的都在第一个说明没问题啦（新版miniconda）

如果C盘在前，位置不对需要调，可以参考该文档最前面的视频链接

如果默认env_dirs在C盘用户下，意味着默认会把环境创建到C盘，推荐更改到miniconda下自带的envs（也就是上面创建的D盘文件夹）

拓展：conda 基础操作

【anaconda】conda创建、查看、删除虚拟环境（anaconda命令集）_conda 创建环境-CSDN博客

3. pip 和 conda 换源 (清华源)

在刚才的conda info 里

这些源都在国外，后期下载包会很慢，甚至会出Error

换源都是在（base）环境里换

换源操作如下：

Conda 替换镜像源方法尽头，再也不用到处搜镜像源地址_conda换源-CSDN博客

省流版：把下面的代码一行一行复制到anaconda prompt里执行，就能完成换源！

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
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/r/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/
conda config --set show_channel_urls yes

4. 安装Jupyter

参考文档：手把手教你安装Jupyter Notebook(保姆级教程)_jupyter notebook安装教程-CSDN博客

省流版：

1. 打开命令提示符：按下 Win + R 键，输入 “cmd”，按下回车键打开命令提示符窗口。

2. 安装 Jupyter Notebook：在命令提示符中输入以下命令，使用 pip 安装 Jupyter Notebook

pip install jupyter -i https://pypi.tuna.tsinghua.edu.cn/simple

（为防止卡顿，这里使用清华源）

3. 启动 Jupyter Notebook（后面会有更优雅的方法）：在命令提示符中输入以下命令，启动 Jupyter Notebook

jupyter notebook

4.接下来Jupyter Notebook 会在默认的浏览器中打开，如果没有自动打开，可以在浏览器中输入 http://localhost:8888/tree 来访问。

（默认的打开目录在C盘用户-个人文件夹）

5. 虚拟环境接入Jupyter

参考文档：【anaconda】conda创建、查看、删除虚拟环境（anaconda命令集）_conda 创建环境-CSDN博客

参考视频：Conda配置虚拟环境 jupyter notebook使用虚拟环境_哔哩哔哩_bilibili

（从6:40开始连接jupyter）

省流版：

1. 创建环境，win+s 搜索并启动 anaconda prompt，输入下方代码（“env-name” 可以替换为我们想要的环境名；这里推荐选择你想要的python版本）

conda create -n env-name python=3.8

2. 进入新环境*：“conda activate d2l-1”进入新创建的虚拟环境就能开始配虚拟环境啦，咱就不展开讲这里了，可参考这个目录作为拓展学习：《动手学深度学习》笔记1——Pytorch虚拟环境搭建-CSDN博客

conda activate d2l-1

d2l-1：是本人起的一个环境名，大家可以自己取名

3. 安装ipykernel库（后面要用它把新环境添加到jupyter内核列表中，并显示）

（conda也可以，但是pip更稳定，咱这里用pip）

pip install ipykernel

显示ipykernel已经就为，就在D盘里

4. 使用ipykernel库，将新环境写入 jupyter 内核(kernel)中并显示出来：

python -m ipykernel install --user --name d2l-1 --display-name d2l-1

--name d2l-1：刚刚创建的新环境(内核)的名称

--display-name d2l-1：设置了该环境(内核)在 Jupyter 接口中显示的内核名称

5. 启动 Jupyter Notebook 查看新内核

jupyter notebook

成功添加！

6. 优雅地启动Jupyter

每次启动都得输入“jupyter notebook”略显繁琐，咱有更优雅的方式，即使用.bat文件简化启动步骤：

1. 打开文本编辑器新建.txt文件（如记事本）。

2. 在文本编辑器中输入以下命令：

@echo off
jupyter notebook

@echo off 是一个批处理命令，用于关闭命令的回显，这样在运行 .bat 文件时不会在命令行窗口中显示这些命令。

jupyter notebook 是启动 Jupyter Notebook 的命令。

3. 将.txt文件保存为带 .bat 扩展名的文件，例如 StartJupyterNotebook.bat。

4. 双击这个 .bat 文件，它就会自动打开命令行窗口并启动 Jupyter Notebook。

5. 这个.bat 文件在哪儿，用它开打的jupyter访问目录就在哪儿，比如我把它放在D盘下app文件夹里：

这样一来，就算是大功告成啦!

可能遇到的问题：jupyter未添加到环境变量

双击.bat文件后没反应，可能是jupyter notebook没有添加到环境变量！

如果win+r 搜"cmd"进入命令提示符，显示为下图，那也说明没jupyter没有添加到环境变量！虽然之前安装过jupyter，但是没有添加到环境变量

如何添加jupyter到环境变量，可参考：jupyter notebook 添加环境变量_运行前请将jupyter添加进系统环境变量-CSDN博客

Win10：右键此电脑(or 我的电脑)——>属性——>高级系统设置——>环境变量——>双击系统变量选择框内的Path，出现编辑环境变量窗口；

Win11：右键此电脑(or 我的电脑)——>属性（关于）——>高级系统设置——>环境变量——>双击系统变量选择框内的Path，出现编辑环境变量窗口；

找到Anaconda安装位置，比如我的安装在E:\anaconda3\中；

选择第一步打开的窗口点击新建，将E:\anaconda3\Scripts和E:\anaconda3\Library\bin分别复制进去，(这是我的安装路径，大家按照自己的，找到对应的Scripts文件夹和Library下的bin文件夹的位置，然后复制 (文件夹位置的文本) 到path里即可)

这下无论是用.bat，还是用cmd(命令提示符)都能打开jupyter啦！

7. 拓展：本地pip安装“包”

拓展：后期如果通过conda (因为是镜像) 源找不到包，可以输用pip本地(离线)安装

遇到安装卡顿（境外源），可以两次 “ctrl+c” 来退出安装

搜pip包：PyPI · The Python Package Index

安装方法：

把.whl 文件 (也就是包) 下载到本地，下面三张截图是个很好的本地虚拟环境安装d2l包的方法，原文链接：从0到1的配置《动手学深度学习》的代码环境_李沐动手学深度学习环境配置-CSDN博客

successful就是成功用pip把包装上啦