Question

重要提示

1. 首先请确认安装 Python 3.7 及以上版本, 这里推荐 Python 3.7.5 版本;

2. AkShare 推荐安装最新版本的 Anaconda, 可以解决大部分安装问题.

安装 AkShare

通用安装

pip install akshare  --upgrade

国内安装-Python

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

国内安装-Anaconda

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 系统

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，对应的命令如下：

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

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

source ~/.bashrc

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

command -v nvm

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

nvm

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

nvm install node

此时终端输出如下内容：

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

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

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

console.log("node 可用");

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

node nodev.js

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

node 可用

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

升级 AkShare

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

pip install akshare --upgrade

R 语言支持

安装 Anaconda

下载 Windows 64 位 Python 3.7 的 Anaconda

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

安装 R 语言

下载 R

下载 RStudio

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

在 R 语言中安装相应的包

Reticulate

install.packages("reticulate")

在安装完成后通过

library(reticulate)
use_python("/usr/local/bin/python")

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

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

library(reticulate)  # 导入 reticulate 包
use_python("/king/local/bin/python")  # 其中的 king 为本地电脑用户名
ak <- import("akshare")  # 类似于 import akshare as ak
stock_df <- ak$stock_em_yysj(date="2020-03-31")  # 类似于 ak.stock_em_yysj(date="2020-03-31")
print(stock_df)  # 查看数据

   scode    sname  trademarket          reportdate              frdate
1 600396 金山股份   上交所主板 2020-03-31T00:00:00 2020-04-08T00:00:00
2 002913   奥士康 深交所中小板 2020-03-31T00:00:00 2020-04-08T00:00:00
3 002007 华兰生物 深交所中小板 2020-03-31T00:00:00 2020-04-08T00:00:00
4 002838 道恩股份 深交所中小板 2020-03-31T00:00:00 2020-04-09T00:00:00
5 603186 华正新材   上交所主板 2020-03-31T00:00:00 2020-04-09T00:00:00
6 300208 青岛中程 深交所创业板 2020-03-31T00:00:00 2020-04-09T00:00:00
               fcdate scdate tcdate              radate securitytypecode
1                   -      -      - 2020-04-08T00:00:00        058001001
2                   -      -      - 2020-04-08T00:00:00        058001001
3                   -      -      - 2020-04-08T00:00:00        058001001
4                   -      -      - 2020-04-09T00:00:00        058001001
5                   -      -      - 2020-04-09T00:00:00        058001001
6 2020-04-16T00:00:00      -      - 2020-04-16T00:00:00        058001001
  trademarketcode
1    069001001001
2    069001002003
3    069001002003
4    069001002003
5    069001001001
6    069001002002

安装报错解决方案

1. 安装 lxml 库失败的错误

• 安装 wheel, 需要在 Windows 的命令提示符中运行如下命令:

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 所在的文件夹, 执行命令即可完成安装, 如下

pip install 带后缀的完整路径和文件名

2. 安装超时的错误

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

Traceback (most recent call last):
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
yield
File "/home/xiaoduc/.pyenv/versions/3.7.3/lib/python3.7/site-packages/pip/_vendor/requests/packages/urllib3/response.py", line 310, in read
data = self._fp.read(amt)
File "/home/xiaoduc/.pyenv/versions/3.7.3/lib/python3.7/site-packages/pip/_vendor/cachecontrol/filewrapper.py", line 49, in read
data = self.__fp.read(amt)

2.解决方案如下:

方法一

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

方法二

使用全局代理解决

3. 拒绝访问错误

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

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

2.解决方案如下:

方法一

pip install akshare --user

方法二

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

4. 提示其他的错误

• 方法一: 升级您的 Anaconda 或者 Python 到 Python3.7.5 及以上版本

• 方法二: 使用 conda 的虚拟环境来安装, 详见 AkShare 环境配置板块的内容