AKShare 安装指导

重要提示

目前 AKShare 仅支持 64 位版本的操作系统安装和使用;
目前 AKShare 仅支持 Python 3.8(64 位) 及以上版本, 这里推荐 Python 3.10.x(64 位) 版本;
AKShare 推荐安装最新版本的 Anaconda (64 位), 可以解决大部分环境配置问题;
对于熟悉容器技术的小伙伴, 可以安装 Docker 使用, 指导教程如下: AKShare Docker 部署.

安装 AKShare

提示：目前已经支持苹果 M1 处理器安装 AKShare，请参考AKShare 文档-苹果 M1 处理器支持

通用安装

pip install akshare  --upgrade

注意：程序运行时，文件名、文件夹名不能是：akshare

国内安装-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

升级 AKShare

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

pip install akshare --upgrade -i https://pypi.org/simple

苹果处理器支持

缘起

AKShare 由于使用 PyMiniRacer 项目来支持在 Python 中运行 JavaScript 代码，所以要完整的使用 AKShare 的全部功能需要安装该库。

但是由于苹果的 M 系列芯片采用 ARM 架构，而 PyMiniRacer 并没有编译相对应的版本，所以造成在 M 系列芯片的计算机上使用 AKShare 会出问题。

解决方案

本次的解决方案是提供编译好的文件供大家下载使用：libmini_racer.dylib ，只需要把该文件下载到本地，然后存放在报错提示的路径即可！

扩展阅读

如果上述文档未能解决您的问题；可以观看《AKShare-初阶-使用教学》课程，里面手把手带您进行环境配置
如果需要编译，请参考该文章：Building V8 on an M1 MacBook

R 语言调用支持

推荐使用 AKTools 项目来部署 AKShare 的 HTTP API 使用，运行速度更快，更稳定，兼容各种编程语言，详情参考 AKTools 文档

安装 Anaconda

下载 Windows 64 位 Python 3.8 的 Anaconda

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

安装 R 语言

下载 R

下载 RStudio

先安装 R，再安装 RStudio，选择默认步骤安装即可。

升级 R 语言到最新版本

Windows

install.packages('installr')
library(installr)
updateR()

Mac

从 CRAN website 网站下载和安装最新的版本，覆盖升级即可。

在 R 语言中安装相应的包

Reticulate

install.packages("reticulate")

在安装完成后通过运行

library(reticulate)
use_python("/usr/local/bin/python")  # 默认使用本地的 Python, 如果需要使用虚拟环境的 Pyhton, 请参考 reticulate 的提示

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

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

library(reticulate)  # 导入 reticulate 包
use_python("/king/local/bin/python")  # 其中的 king 为本地计算机用户名
# use_condaenv(condaenv="ak_test", required = TRUE)  # 也可以使用 conda 创建的虚拟环境，其中的 ak_test 为虚拟环境名称
ak <- import("akshare")  # 类似于 import akshare as ak
stock_df <- ak$stock_zh_a_hist()  # 类似于 ak.stock_zh_a_hist()
head(stock_df)  # 查看数据

        日期  开盘   收盘  最高   最低     成交量 成交额  振幅  涨跌幅 涨跌额 换手率    
1 1991-04-03 49.00 49.00 49.00 49.00      1   5000    0  22.50   9.00  0  
2 1991-04-04 48.76 48.76 48.76 48.76      3  15000    0  -0.49  -0.24  0  
3 1991-04-05 48.52 48.52 48.52 48.52      2  10000    0  -0.49  -0.24  0  
4 1991-04-06 48.28 48.28 48.28 48.28      7  34000    0  -0.49  -0.24  0  
5 1991-04-08 48.04 48.04 48.04 48.04      2  10000    0  -0.50  -0.24  0  
6 1991-04-09 47.80 47.80 47.80 47.80      4  19000    0  -0.50  -0.24  0

MATLAB 调用支持

推荐使用 AKTools 项目来部署 AKShare 的 HTTP API 使用，运行速度更快，更稳定，兼容各种编程语言，详情参考 AKTools 文档

测试环境配置

在 MATLAB 命令行窗口输入

pyenv

如返回

pe =

  PythonEnvironment - 属性:

          Version: "3.8"
       Executable: "C:\Anaconda3\envs\ak_test\python.exe"
          Library: "C:\Anaconda3\envs\ak_test\python38.dll"
             Home: "C:\Anaconda3\envs\ak_test"
           Status: Loaded
    ExecutionMode: InProcess
        ProcessID: "26560"
      ProcessName: "MATLAB"

则表示可以正常使用 C:\Anaconda3\envs\ak_test\python.exe 环境的 Python，同时确保在该环境中已经安装最新版的 AKShare。

测试调用 AKShare 接口

在 MATLAB 命令行窗口输入

py.akshare.stock_zh_a_hist

如返回

ans =

  Python DataFrame - 属性:

          T: [1×1 py.pandas.core.frame.DataFrame]
         at: [1×1 py.pandas.core.indexing._AtIndexer]
      attrs: [1×1 py.dict]
       axes: [1×2 py.list]
    columns: [1×1 py.pandas.core.indexes.base.Index]
     dtypes: [1×1 py.pandas.core.series.Series]
      empty: 0
        iat: [1×1 py.pandas.core.indexing._iAtIndexer]
       iloc: [1×1 py.pandas.core.indexing._iLocIndexer]
      index: [1×1 py.pandas.core.indexes.range.RangeIndex]
        loc: [1×1 py.pandas.core.indexing._LocIndexer]
       ndim: [1×1 py.int]
      shape: [1×2 py.tuple]
       size: [1×1 py.numpy.int32]
      style: [1×1 py.pandas.io.formats.style.Styler]
     values: [1×1 py.numpy.ndarray]

                  日期     开盘     收盘     最高  ...    振幅    涨跌幅   涨跌额   换手率
    0     1991-04-03  49.00  49.00  49.00  ...  0.00  22.50  9.00  0.00
    1     1991-04-04  48.76  48.76  48.76  ...  0.00  -0.49 -0.24  0.00
    2     1991-04-05  48.52  48.52  48.52  ...  0.00  -0.49 -0.24  0.00
    3     1991-04-06  48.28  48.28  48.28  ...  0.00  -0.49 -0.24  0.00
    4     1991-04-08  48.04  48.04  48.04  ...  0.00  -0.50 -0.24  0.00
    ...          ...    ...    ...    ...  ...   ...    ...   ...   ...
    7298  2021-11-04  18.08  17.87  18.10  ...  1.66  -0.89 -0.16  0.51
    7299  2021-11-05  17.85  17.64  18.00  ...  2.41  -1.29 -0.23  0.56
    7300  2021-11-08  17.62  17.42  17.81  ...  2.55  -1.25 -0.22  0.71
    7301  2021-11-09  17.48  17.53  17.65  ...  2.24   0.63  0.11  0.64
    7302  2021-11-10  17.46  17.40  17.47  ...  1.77  -0.74 -0.13  0.63

    [7303 rows x 11 columns]

则表示可以在 MATLAB 中调用 AKShare 的数据接口。

调用 AKShare

不带参数接口调用

在 MATLAB 命令行窗口输入

py.akshare.macro_cnbs

如返回

ans =

  Python DataFrame - 属性:

          T: [1×1 py.pandas.core.frame.DataFrame]
         at: [1×1 py.pandas.core.indexing._AtIndexer]
      attrs: [1×1 py.dict]
       axes: [1×2 py.list]
    columns: [1×1 py.pandas.core.indexes.base.Index]
     dtypes: [1×1 py.pandas.core.series.Series]
      empty: 0
        iat: [1×1 py.pandas.core.indexing._iAtIndexer]
       iloc: [1×1 py.pandas.core.indexing._iLocIndexer]
      index: [1×1 py.pandas.core.indexes.range.RangeIndex]
        loc: [1×1 py.pandas.core.indexing._LocIndexer]
       ndim: [1×1 py.int]
      shape: [1×2 py.tuple]
       size: [1×1 py.numpy.int32]
      style: [1×1 py.pandas.io.formats.style.Styler]
     values: [1×1 py.numpy.ndarray]

              年份       居民部门     非金融企业部门  ...      实体经济部门    金融部门资产方    金融部门负债方
    0    1993-12   8.311222   91.658000  ...  107.791459   8.896441   7.128428
    1    1994-12   7.808230   82.411703  ...   98.354271   9.808787   6.796868
    2    1995-12   8.200000   81.000000  ...   97.900000  10.000000   7.000000
    3    1996-03   8.400000   81.700000  ...   99.200000  10.200000   7.200000
    4    1996-06   8.600000   82.100000  ...   99.700000  10.400000   7.400000
    ..       ...        ...         ...  ...         ...        ...        ...
    101  2020-09  61.700000  164.600000  ...  271.200000  55.800000  62.400000
    102  2020-12  62.200000  162.300000  ...  270.100000  54.200000  62.700000
    103  2021-03  62.100000  161.400000  ...  267.800000  52.800000  62.300000
    104  2021-06  62.000000  158.800000  ...  265.400000  51.300000  61.700000
    105  2021-09  62.100000  157.200000  ...  264.800000  49.200000  61.900000

    [106 rows x 9 columns]

则表示可以在 MATLAB 中调用 AKShare 的不带参数的接口。

带参数接口调用

在 MATLAB 命令行窗口输入

% 注意其中的传参方式，从左到右，依次传递参数，形参（及其‘=’）都不需要，参数必须按顺序传递
py.akshare.stock_zh_a_hist("000001", "daily", "20170301", '20210907', "")

如返回

ans =

  Python DataFrame - 属性:

          T: [1×1 py.pandas.core.frame.DataFrame]
         at: [1×1 py.pandas.core.indexing._AtIndexer]
      attrs: [1×1 py.dict]
       axes: [1×2 py.list]
    columns: [1×1 py.pandas.core.indexes.base.Index]
     dtypes: [1×1 py.pandas.core.series.Series]
      empty: 0
        iat: [1×1 py.pandas.core.indexing._iAtIndexer]
       iloc: [1×1 py.pandas.core.indexing._iLocIndexer]
      index: [1×1 py.pandas.core.indexes.range.RangeIndex]
        loc: [1×1 py.pandas.core.indexing._LocIndexer]
       ndim: [1×1 py.int]
      shape: [1×2 py.tuple]
       size: [1×1 py.numpy.int32]
      style: [1×1 py.pandas.io.formats.style.Styler]
     values: [1×1 py.numpy.ndarray]

                  日期     开盘     收盘     最高  ...    振幅   涨跌幅   涨跌额   换手率
    0     2017-03-01   9.49   9.49   9.55  ...  0.84  0.11  0.01  0.21
    1     2017-03-02   9.51   9.43   9.54  ...  1.26 -0.63 -0.06  0.24
    2     2017-03-03   9.41   9.40   9.43  ...  0.74 -0.32 -0.03  0.20
    3     2017-03-06   9.40   9.45   9.46  ...  0.74  0.53  0.05  0.24
    4     2017-03-07   9.44   9.45   9.46  ...  0.63  0.00  0.00  0.17
    ...          ...    ...    ...    ...  ...   ...   ...   ...   ...
    1100  2021-09-01  17.48  17.88  17.92  ...  5.11  0.45  0.08  1.19
    1101  2021-09-02  18.00  18.40  18.78  ...  5.48  2.91  0.52  1.25
    1102  2021-09-03  18.50  18.04  18.50  ...  4.35 -1.96 -0.36  0.72
    1103  2021-09-06  17.93  18.45  18.60  ...  4.55  2.27  0.41  0.78
    1104  2021-09-07  18.60  19.24  19.56  ...  6.56  4.28  0.79  0.84

    [1105 rows x 11 columns]

则表示可以在 MATLAB 中调用 AKShare 的带参数的接口。

转换数据格式

友情提示

首先感谢群友的帮助，特此提供在 MATLAB 中转化 Pandas 格式数据为在 MATLAB 中可以用的数据类型
下载该函数文件到当前用户文件统一目录下

演示

% 导入 AKShare 库
ak = py.importlib.import_module('akshare');
% 代用 AKShare 数据接口
temp_df = ak.stock_zh_a_hist();
% 转化数据格式
df = py2matlab(temp_df);
% 展示获取到本地的数据
disp(df)

安装报错解决方案

1. 安装 lxml 库失败的错误

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

pip install wheel

在这里下载与您的 Python 版本对应的 .whl 文件, 注意别改文件名!

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

进入 .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/Anaconda/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. 提示其他的错误

方法一: 确认并升级您已安装 64 位的 Python 3.8 及以上版本
方法二: 使用 conda 的虚拟环境来安装, 详见 AKShare 环境配置 板块的内容

AKShare 安装指导 ​

重要提示 ​

安装 AKShare ​

通用安装 ​

国内安装-Python ​

国内安装-Anaconda ​

升级 AKShare ​

苹果处理器支持 ​

缘起 ​

解决方案 ​

扩展阅读 ​

R 语言调用支持 ​

安装 Anaconda ​

安装 R 语言 ​

升级 R 语言到最新版本 ​

Windows ​

Mac ​

在 R 语言中安装相应的包 ​

MATLAB 调用支持 ​

安装 Anaconda ​

安装 MATLAB ​

配置环境 ​

测试环境配置 ​

测试调用 AKShare 接口 ​

调用 AKShare ​

不带参数接口调用 ​

带参数接口调用 ​

转换数据格式 ​

友情提示 ​

演示 ​

安装报错解决方案 ​

1. 安装 lxml 库失败的错误 ​

2. 安装超时的错误 ​

3. 拒绝访问错误 ​

4. 提示其他的错误 ​

AKShare 安装指导

重要提示

安装 AKShare

通用安装

国内安装-Python

国内安装-Anaconda

升级 AKShare

苹果处理器支持

缘起

解决方案

扩展阅读

R 语言调用支持

安装 Anaconda

安装 R 语言

升级 R 语言到最新版本

Windows

Mac

在 R 语言中安装相应的包

MATLAB 调用支持

安装 Anaconda

安装 MATLAB

配置环境

测试环境配置

测试调用 AKShare 接口

调用 AKShare

不带参数接口调用

带参数接口调用

转换数据格式

友情提示

演示

安装报错解决方案

1. 安装 lxml 库失败的错误

2. 安装超时的错误

3. 拒绝访问错误

4. 提示其他的错误