AkShare 安装指导

重要提示

  1. 首先请确认安装 Python 3.7(64 位) 及以上版本, 这里推荐 Python 3.8.5(64 位) 版本;
  2. AkShare 推荐安装最新版本的 Anaconda, 可以解决大部分安装问题.

安装 AkShare

通用安装

  1. pip install akshare  --upgrade

国内安装-Python

  1. pip install akshare -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com  --upgrade

国内安装-Anaconda

  1. pip install akshare -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com  --user  --upgrade

安装 Node.js

P.S. 体验 AkShare 完整功能, 请安装 Node.js

快速安装

Windows 系统

点击下载 Node.js for win 64, 按照界面提示完成安装即可！

Ubuntu 系统

  1. sudo apt-get install nodejs

详细安装

Node.js 介绍

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，它的存在使开发者可以在不依赖游览器的情况下编译和运行 JavaScript 代码。

Node.js 相关链接

  1. Node.js 官网
  2. NVM 的 GitHub 仓库

Node.js 详细安装

我们既可以从 Node.js 官网 下载安装包，也可以通过它的版本管理工具 NVM 来安装它。使用 NVM 的好处是可以在计算机中 安装多个版本的 Node.js，并且安装过程也比较简单。

首先下载并安装 NVM，对应的命令如下：

  1. wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash

然后刷新环境变量，对应的命令如下：

  1. source ~/.bashrc

接着验证 NVM 是否安装成功。在终端执行以下命令：

  1. command -v nvm

此时终端会输出如下内容：

  1. nvm

这代表 NVM 已经成功安装，并且正常运行。接着就可以安装 Node.js 了，在终端执行以下命令：

  1. nvm install node

此时终端输出如下内容：

  1. Downloading and installing node v13.12.0...
  2. Downloading https://nodejs.org/dist/v13.12.0/node-v13.12.0-linux-x64.tar.xz...
  3. ################################################################################################################################################################## 100.0%
  4. Computing checksum with sha256sum
  5. Checksums matched!
  6. Now using node v13.12.0 (npm v6.14.4)
  7. Creating default alias: default -> node (-> v13.12.0)

这代表 Node.js 最新版本已被下载并安装。

接下来验证 Node.js 是否已经安装成功。新建一个 nodev.js 的文件，并将以下内容写入文件：

  1. console.log("node 可用");

最后在同级目录下唤起终端，在终端执行以下命令：

  1. node nodev.js

如果此时终端输出如下内容：

  1. node 可用

代表 Node.js 已经成功安装，并且正常运行。

升级 AkShare

P.S. 由于目前版本更新迭代频繁, 请在使用 AkShare 前先升级, 命令如下所示

  1. pip install akshare --upgrade

R 语言支持

安装 Anaconda

下载 Windows 64 位 Python 3.8 的 Anaconda

安装教程参见 AkShare 文档的环境配置专栏

安装 R 语言

下载 R

下载 RStudio

先安装 R，再安装 RStudio，按一下步安装即可。

在 R 语言中安装相应的包

Reticulate

  1. install.packages("reticulate")

在安装完成后通过

  1. library(reticulate)
  2. use_python("/usr/local/bin/python")

调用本地的 Python 程序，其中 usr 需要替换为本地电脑的用户名。

最后展示一段演示代码，此代码在 R 语言中通过 reticulate 包来调用 AkShare 获取数据：

  1. library(reticulate)  # 导入 reticulate 包
  2. use_python("/king/local/bin/python")  # 其中的 king 为本地电脑用户名
  3. ak <- import("akshare")  # 类似于 import akshare as ak
  4. stock_df <- ak$stock_em_yysj(date="2020-03-31")  # 类似于 ak.stock_em_yysj(date="2020-03-31")
  5. print(stock_df)  # 查看数据
  1.    scode    sname  trademarket          reportdate              frdate
  2. 1 600396 金山股份   上交所主板 2020-03-31T00:00:00 2020-04-08T00:00:00
  3. 2 002913   奥士康 深交所中小板 2020-03-31T00:00:00 2020-04-08T00:00:00
  4. 3 002007 华兰生物 深交所中小板 2020-03-31T00:00:00 2020-04-08T00:00:00
  5. 4 002838 道恩股份 深交所中小板 2020-03-31T00:00:00 2020-04-09T00:00:00
  6. 5 603186 华正新材   上交所主板 2020-03-31T00:00:00 2020-04-09T00:00:00
  7. 6 300208 青岛中程 深交所创业板 2020-03-31T00:00:00 2020-04-09T00:00:00
  8.                fcdate scdate tcdate              radate securitytypecode
  9. 1                   -      -      - 2020-04-08T00:00:00        058001001
  10. 2                   -      -      - 2020-04-08T00:00:00        058001001
  11. 3                   -      -      - 2020-04-08T00:00:00        058001001
  12. 4                   -      -      - 2020-04-09T00:00:00        058001001
  13. 5                   -      -      - 2020-04-09T00:00:00        058001001
  14. 6 2020-04-16T00:00:00      -      - 2020-04-16T00:00:00        058001001
  15.   trademarketcode
  16. 1    069001001001
  17. 2    069001002003
  18. 3    069001002003
  19. 4    069001002003
  20. 5    069001001001
  21. 6    069001002002

安装报错解决方案

1. 安装 lxml 库失败的错误

  • 安装 wheel, 需要在 Windows 的命令提示符中运行如下命令:
  1. pip install wheel
  • 在这里下载与您的 Python 版本对应的 .whl 文件, 注意别改文件名!

以下提供 64 位电脑的版本, 所以下载对应的 64 位就可以, 点击如下链接也可以下载:

  1. lxml‑4.5.0‑cp36‑cp36m‑win_amd64.whl
  2. lxml‑4.5.0‑cp37‑cp37m‑win_amd64.whl
  3. lxml‑4.5.0‑cp38‑cp38‑win_amd64.whl
  • 进入 .whl 所在的文件夹, 执行命令即可完成安装, 如下
  1. pip install 带后缀的完整路径和文件名

2. 安装超时的错误

1.大致报错如下, 出现关键词 amt :

  1. Traceback (most recent call last):
  2. File "/home/xiaoduc/.pyenv/versions/3.7.3/lib/python3.7/site-packages/pip/_vendor/requests/packages/urllib3/response.py", line 228, in _error_catcher
  3. yield
  4. File "/home/xiaoduc/.pyenv/versions/3.7.3/lib/python3.7/site-packages/pip/_vendor/requests/packages/urllib3/response.py", line 310, in read
  5. data = self._fp.read(amt)
  6. File "/home/xiaoduc/.pyenv/versions/3.7.3/lib/python3.7/site-packages/pip/_vendor/cachecontrol/filewrapper.py", line 49, in read
  7. data = self.__fp.read(amt)

2.解决方案如下:

方法一

  1. pip --default-timeout=100 install -U akshare

方法二

使用全局代理解决

3. 拒绝访问错误

1.大致报错如下, 出现关键词 拒绝访问 :

  1. Could not install packages due to an EnvironmentError: [Errno 13] Permission denied: '/Users/mac/Anaconda/anaconda3/lib/python3.7/site-packages/cv2/__init__.py'
  2. Consider using the `--user` option or check the permissions.

2.解决方案如下:

方法一

  1. pip install akshare --user

方法二

使用管理员权限(右键单击选择管理员权限)打开 Anaconda Prompt 进行安装

4. 提示其他的错误

  • 方法一: 确认并升级您的 Anaconda 或者 Python 到 64 位的 Python3.7 及以上版本
  • 方法二: 使用 conda 的虚拟环境来安装, 详见 AkShare 环境配置 板块的内容