d2l包安装教程

目录

一、下载d2l包

1、错误的安装方法

2、正确的安装方法

二、可能会遇到的问题

1、网络超时导致下载中断

2、windows powershell激活虚拟环境时报错

---

一、下载d2l包

       直接按照教程安装 — 动手学深度学习 2.0.0 documentation运行命令pip install d2l==0.17.6安装会比较慢，很大可能会因为网络超时导致安装中断，网上也有很多人遇到这个问题，他们几乎都使用了下面的安装方法。

1、错误的安装方法

       网上大多数博主给的解决方案是先在网站Python d2l项目安装包(第三方库)下载资源下载0.15.1版本的wheel文件后再进行安装。

       如图，把d2l包复制到我创建的虚拟环境d2learn下的site-packages目录下，然后cd到这个文件目录下或者直接右键选择“在终端中打开”，然后激活虚拟环境：

conda activate env-name

       然后安装wheel文件：

pip install .\d2l-0.15.1-py3-none-any.whl

2、正确的安装方法

       我一开始是按照前面的错误的安装方法进行安装的，一开始都没有什么问题，但是到学习到“数据增广”那一节时运行chapter_computer-vision\image-augmentation.ipynb的时候出现报错。

       显示“AttributeError: module 'd2l.torch' has no attribute 'Image'”，原因是版本不对造成代码运行错误，书上要求的是最低版本为0.17.5，而前面错误的方法安装的是0.15.1，所以是因为版本不对导致的。

       为了防止安装过程中因为网络超时而导致中断，拟采用以下两种方案：

方案一：pip的时候使用--default-timeout=500

       执行以下命令：

pip --default-timeout=500 install d2l==0.17.6

方案二：使用国内源找到对应版本进行安装

       可以使用华为云链接进行下载安装，如图：

       下载后pip安装即可。

参考：d2l包下载出错与module ‘d2l.torch‘ has no attribute_ 问题解决_module 'd2l.torch' has no attribute 'train_ch3-CSDN博客

二、可能会遇到的问题

1、网络超时导致下载中断

       因为需要下载和安装的包太多，有些包下载的时候可能会因为网络超时导致下载失败，如下图所示。

       可以看到终端出现“raise ReadTimeoutError(self._pool, None, "Read timed out.")
pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Read timed out.”错误信息，超时的原因是网络连接不稳定，可以使用如下方法：

pip --default-timeout=500 install .\d2l-0.15.1-py3-none-any.whl

       注意，等号后面的数字可以调整。

参考：【pip】快速解决 pip 下载安装超时问题 (ReadTimeoutError)_pip read timed out-CSDN博客

2、windows powershell激活虚拟环境时报错

       完整的报错信息是：

CommandNotFoundError: Your shell has not been properly configured to use 'conda activate'.
To initialize your shell, run

    $ conda init <SHELL_NAME>

Currently supported shells are:
  - bash
  - fish
  - tcsh
  - xonsh
  - zsh
  - powershell

See 'conda init --help' for more information and options.

IMPORTANT: You may need to close and restart your shell after running 'conda init'.

       可以按照提示执行 conda init 命令，但是执行命令后又会出现新的报错信息（具体是什么内容我忘记了，但是主要是和系统不能自动执行一个bat文件有关），可以将报错信息复制粘贴到网上找解决方案。