<style> .markdown-body img{ width:100%; background:#000; border:1px solid #fff; border-width:5px 5px 5px 5px; box-shadow:1px 1px 5px #333; -webkit-box-shadow:1px 1px 5px #333; -moz-box-shadow:1px 1px 5px #333; } </style> > 本文介绍了 Windows 下 Anaconda 安装的一般步骤，如果你仅仅是因为中文账户名（即 C:\用户\你的登录账户文件夹 为中文）导致 Jupyter 无法使用而浏览此文，请直接参阅跳转到 [中文账户名的补充操作](#中文账户名的补充操作) 章节 # 目录 [toc] # Anaconda 简介 Anaconda 集成了 Python解释器、包/环境管理工具 conda 、常用的第三方数据科学包例如 numpy/pandas/matplotlib/scikit-learn 等，安装完毕后开箱即用，避免了无法联网下载或者网速过慢造成无法下载第三方包的尴尬。但也正因为附加了大量的第三方库，导致安装包体积较大，通常约 500M 左右，如果只需要基本的 Python 解释器和 conda 工具，其它包按需下载安装，那么可以使用 [miniconda](https://docs.conda.io/en/latest/miniconda.html) 。 # 下载安装包 [官方网站](https://www.anaconda.com/) 由于是国外站点，下载速度较慢，建议从国内镜像站，例如 [清华大学开源软件镜像站](https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/) 下载，该网址列出了所有版本不同平台的安装包，请按照日期降序排列后根据自己环境下载  其中： - 带有 Windows 字样的为 Windows 平台安装包，带有 X86_64 字样为 64 位安装包，仅带有 X86 字样的为 32 位安装包。 - 带有 MacOSX 字样的为 MacOS 即苹果操作系统的安装包，通常选择 pkg 封装形式。 - 带有 Linux 字样的为 Linux 平台的安装包。 本文档使用的安装包为 [Anaconda3-2021.05-Windows-x86_64.exe](https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-2021.05-Windows-x86_64.exe) <div class="alert alert-danger"> 2024/3/1 更新：目前已经测试过可以正常工作的新版本为 2023.3 或者 2023.7 版本，这也是公共机房安装的版本，其它更新的版本未经测试，不建议使用。 </div> # 安装过程 双击执行下载的安装包，阅读完说明后点击 `Next`  点击 `I Agree` 同意协议  接下来选择是仅为当前用户(`Just Me`) 还是为所有用户(`All Users`)安装，如果你知道你当前的 Windows 账户具有管理员权限，那么可以选择 `All Users`，如果你不确认，使用默认的 `Just Me` 即可。  在接下来的安装路径对话框中，如果你的当前 Windows 账户（C:\用户\文件夹下的账户文件夹名称）为英文，请直接使用默认给出的路径，**如果你是中文账户名，请务必修改为其它不带中文的文件夹，且尽量简短，例如 `d:\anaconda3` 。**  在接下来的配置参数中，保持默认即可。  耐心等待安装完成，尤其是在最后的环节耗时较长  在安装完毕的界面中，取消最后页面选中的两项，然后点击 `Finish` 完成安装。 # 中文账户名的补充操作 **如果你的账户名（C:\用户\文件夹下的账户文件夹名称）为中文，在安装时请务必选择非中文安装路径**，否则请卸载后重新安装，安装完毕后按照如下步骤操作。 你可以尝试两种方案解决可能因为中文账户名导致的内核非法退出、代码无法运行、文件无法保存等问题： 方案1： 按 Win+R 在运行对话框中输入 cmd 进入控制台，然后依次输入如下指令并回车更改当前账户的临时目录 ``` setx TMP C:\Windows\Temp setx TEMP c:\Windows\Temp ``` 然后尝试重新启动 Jupyter 看能否正常工作。 方案2： 确保你安装的 Anaconda 版本为本文的 2021.5，如果不是，请从控制面板卸载当前版本并重新下载安装 2021.5 版本的 Anaconda。 将计算机连接互联网，从开始菜单的 `Anaconda 3` 选项中，启动 `Anaconda Prompt` 即控制台窗口  输入如下代码安装 pyzmq 的 19.0.2 版本 ``` pip uninstall pyzmq && pip install pyzmq==19.0.2 ``` 如果提示权限问题，可以尝试输入 ``` pip uninstall pyzmq && pip install pyzmq==19.0.2 --user ```  在接下来询问是否继续的提示中输入 `y` 并回车  等待安装完成，最后会有红色的 `Error` 提示，忽略即可。  重新启动 Jupyter 测试功能是否正常。 # 功能测试 从开始菜单 `Anaconda 3` 的选项中，启动 `Jupyter Notebook`  控制台窗口会开启 Jupyter 并开始提供服务，**注意控制台窗口在 Jupyter 使用期间不要关闭**  如果 Jupyter 能够探测到浏览器，会自动启动浏览器并打开控制台窗口的链接地址，如果失败，则需要用户手动拷贝上述地址到浏览器的地址栏，然后回车打开 Jupyter 的前台页面。  浏览器页面默认会显示当前 Windows 账户的主文件夹中的子文件夹和文件列表，Windows 账户主文件夹通常为 `C:\用户\xxx` ，其中 `xxx` 为你的账户名，你可以使用资源管理器打开查看该文件夹下的文件，虽然二者显示的语言不同，但其实是一个地方。 > 小技巧：按键盘上的 `Win+R` 输入 `%userprofile%` 回车可以快速打开账户主文件夹。  接下来新建一个笔记本页面，在页面右上方的 `New` 按钮下选择 `Python3` 内核（或者列出来的其它 Python 内核）  浏览器会自动打开一个新标签窗口并为此笔记本页面关联选择的内核，该笔记本页面的名称通常为 `Untitled xx`，其中 `xx` 为依次递增的序号。  用户可以观察你的账户文件夹下此时也会多出一个扩展名为 `.ipynb` 名称为 `Untitled xx` 的文件，该文件即是刚才新建的笔记本页面。 > 注意：通常在 `Untitled.ipynb` 文件同级目录下还可能会存在有 `.ipynb_checkpoints` 的文件夹，该文件夹是 Jupyter 用来记录笔记本状态的，和用户无关。  在浏览器的笔记本页面中，单击第一个单元格，填写如下代码并 `Ctrl+回车` 或者点击顶部的 `运行` 按钮，即可看到代码的运行结果。  至此，Anaconda 安装完毕且能够正确运行。 关于 Jupyter 的详细使用，请参阅：[https://docs.hebut.online/s/jupyter](https://docs.hebut.online/s/jupyter) # 更改默认存储位置 Jupyter Notebook 默认打开的位置为当前 Windows 账户主目录，很多情形下我们期望修改为其它位置，比如 `D:\Code` ，这可以通过两种方案来进行 ## 临时性修改 首先从开始菜单的 `Anaconda 3` 选项组中点击 `Anaconda Prompt` 进入控制台，然后使用 `D:` 回车切换到 `D` 分区，使用 `cd Code` 命令进入 `Code` 文件夹，使用 `jupyter notebook .` 即可打开 Jupyter 并把当前文件夹做为存放笔记本文档的主目录。  如果对控制台切换目录指令不熟悉，直接打开控制台后输入 `jupyter notebook --notebook-dir="d:\Code"` 也可以将 `D:\Code` 做为主文件夹。 无论哪种，这种修改都是临时性的，重新启动 Jupyter ，默认仍是账户主目录。 ## 永久性修改 如果需要永久性修改启动的默认文件夹，可以将 `notebook-dir` 参数存储在配置文件中，但默认配置文件是不存在的，需要在 `Anaconda Prompt` 控制台下使用如下代码生成。 ``` jupyter notebook --generate-config ``` 此时会在用户账户主目录的 `.jupyter` 文件夹中生成配置文件 `jupyter_notebook_config.py`  用户可以通过使用任意文本编辑器打开它并取消 `c.NotebookApp.notebook_dir` 参数前的 `#` ，然后修改其值为你指定的文件夹。  然后重新启动 Jupyter 即可。 # 使用国内源 > 提示：如果你的网络连接速度尚可，使用国内镜像站的步骤不是必须的。 在使用 `pip` 或者 `conda` 指令安装或者升级第三方包的过程中，Anaconda 默认会连接官方服务器，由于官方服务器在国外，经常因为网络原因连接出错或者下载缓慢，此时可以使用国内镜像源。 这里以 [清华镜像站](https://mirrors.tuna.tsinghua.edu.cn) 为例介绍如何加速 Anaconda 。 在镜像站首页的搜索框里搜索 `Anaconda` ，点击搜索结果中的问号获取帮助信息  帮助页面提供了 Anaconda 镜像的使用方式及配置细节，主要操作步骤如下： 在 `Anaconda Prompt` 控制台执行如下指令生成配置文件 ``` conda config --set show_channel_urls yes ``` 然后使用任意文本编辑器编辑用户 Windows 账号主文件夹下的 `.condarc` 文件，将如下内容替换原内容。 ``` channels: - defaults show_channel_urls: true default_channels: - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2 custom_channels: conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud menpo: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud ``` 最后使用 `conda clean -i` 更新缓存即可。