akshare：新手第一数据源的上手与性格
我的掌握程度：
先掌握这个答案
数据版图：行情（股票/基金/期货/债券/加密）、财务、宏观、指数成分、龙虎榜、北向——百余个接口覆盖个人研究九成需求。三个脾气与对策：①接口不稳（底层是网页抓取，网站改版即失效）——对策：固定版本（requirements锁版本）+失败重试+备用接口；②字段口径漂移（列名/单位随源变化）——对策：下载后立即做字段校验与单位检查（q-060体检）；③限频——对策：sleep礼貌+增量缓存（q-329专讲）。与tushare分工：akshare广而免费（探索期）、tushare规整需积分（财务与成分类更稳）——研究主食akshare、关键数据tushare交叉验证。
先读结论，再核对下方使用边界；数字例题为教学情景，涉及实际行情与规则时请核对原始来源。
从理解到使用
本阶段实战方法 · 一条能复现的数据流水线
把接口返回的数据变成可用于因子研究的面板时，先处理时点、主键与单位。
- 建立数据字典：字段、单位、时区、交易日历、数据源、抓取时间、原始价与复权因子。
- 用(date, code)查重，区分停牌、未上市、窗口不足和真实缺失；不要用向后填充把未来值带回过去。
- 保存原始快照与清洗日志，固定随机种子和环境版本；接口字段变化时先核对官方文档。
使用边界
- 报告期不等于公告可用日，盘后公告通常不能用于当天收盘前决策。
- API输出名为“动态市盈率”时不能直接改名TTM；浏览器练习不支持任意原生库或行情抓取接口。
背景 · 从一个困惑说起
二十年前个人想拿全市场历史行情要花钱买光盘；akshare（免费开源的Python财经数据库）把这件事变成一行pip。它是本课程数据环节的默认起点——但免费有免费的脾气，你得懂它。
由此产生的问题
akshare能拿到什么（数据版图）？它的三个脾气（网页抓取的不稳定/字段口径变化/限频）怎么应对？与tushare的分工？
核心概念
数据版图：行情（股票/基金/期货/债券/加密）、财务、宏观、指数成分、龙虎榜、北向——百余个接口覆盖个人研究九成需求。三个脾气与对策：①接口不稳（底层是网页抓取，网站改版即失效）——对策：固定版本（requirements锁版本）+失败重试+备用接口；②字段口径漂移（列名/单位随源变化）——对策：下载后立即做字段校验与单位检查（q-060体检）；③限频——对策：sleep礼貌+增量缓存（q-329专讲）。与tushare分工：akshare广而免费（探索期）、tushare规整需积分（财务与成分类更稳）——研究主食akshare、关键数据tushare交叉验证。
为什么需要它
①零成本启动研究是本课程的承诺：akshare让「资金」不再是学习量化的门槛——时间才是唯一投入；②免费数据的清洗责任自负（q-065的伏笔）：口径、缺失、复权都要自己把关——这恰是最好的训练；③接口不稳定是特性不是缺陷：把「下载→校验→缓存」写成健壮脚本的过程，就是数据工程能力的形成过程。
实际应用场景
起步三接口：stock_zh_a_hist（日线）、stock_zh_a_spot_em（实时快照）、index_zh_a_hist（指数）——覆盖毕业项目全部需求；每天增量更新走q-328的流程。
与之前知识的联系
本课程阶段4起所有代码示例的数据默认来源；q-322~325是它的四个同事；q-328/329（下载流程与限频）是与它配合的工程动作。
⚠ 常见误解
- 免费数据=不可靠：数据本身可靠（抓自权威页面），不可靠的是接口的稳定性——工程化后完全可用于研究
- 报错就是库坏了：多是源网站改版——查GitHub issue、锁旧版本或换接口；报错信息里通常有线索
- akshare的数据可以直接进回测：必须先过体检与清洗（复权口径/停牌/单位）——q-060/065的流程不能省
🛠 本题实践任务
安装akshare并跑通safe_fetch模板下载3只股票（注意打印列名并记录单位）；故意断网测一次重试逻辑。把列名与单位写进你的数据字典（data dictionary）。
💡 提示（先自己想5分钟再看）
数据字典=每个字段的名称/含义/单位/口径的表格——研究复现的最便宜保险。
✅ 验收标准
3只股票落盘+一份初始数据字典+一次重试观察。你的数据管道正式破土。
在你的浏览器内运行。首次需联网下载 Python；支持标准库和 Pyodide 提供的 NumPy、pandas 等包。行情抓取、系统文件访问和部分第三方库请在本地环境运行。输出自检仅比对结果关键词，不代替逻辑审查。
Python · 独立工作线程 · 执行限时10秒
🤖 AI导师
导师会先检查你的前置知识（数据类型、pip安装），再用案例、公式和代码帮助理解。此功能需要先启用服务。