PyQt+Akshare股票分析软件源码：K线绘制与数据线程实战

简介这份源码面向对量化分析与桌面应用开发感兴趣的Python学习者提供了一套名为“上帝之手股票分析软件”的完整实现方案借助Akshare接口实时抓取股票行情并通过PyQt构建可视化界面解决股票数据获取、处理与K线图展示的一体化需求。资源包共32个文件、约7.17MB以10个Python脚本为核心配合2个ui界面文件、5个Markdown说明文档、5张jpg与1张png示意图、4个txt数据文件以及whl依赖包、批处理安装脚本和演示视频覆盖从环境搭建到功能演示的完整链路。目录中按模块划分了数据更新线程、K线绘制、信号基类与表格控件等组件便于理解PyQt与Akshare的协作方式。目前已有420人学习下载适合希望参考桌面端股票分析工具架构、复用K线图绘制与实时数据抓取思路的开发者研读。1. 上帝之手股票分析软件一份能跑起来的 PyQt Akshare 桌面端源码很多人第一次接触股票数据可视化都是被“实时行情 K 线图”这个组合吸引进来的。但真动手时才发现数据接口、GUI 框架、绘图库三件事凑在一起环境能卡掉一半人。这份“上帝之手股票分析软件”源码就是一套把 Akshare 数据抓取、PyQt 界面、pyqtgraph K 线绘制串起来的完整桌面端工程30 个文件里包含 8 个 Python 脚本、2 个 .ui 界面文件、1 个 TA-Lib 的 whl 离线包和一份演示视频。它适合两类人一是想学 PyQt 做金融桌面应用的 Python 入门者二是需要一套能改的行情看板骨架、不想从零搭界面的开发者。下面按“能跑起来 → 看懂结构 → 改得动 → 不踩坑”的顺序拆一遍。2. 环境搭建与依赖安装从 whl 离线包到 PyQt 运行时这套源码能不能顺利跑起来八成取决于环境。项目里直接塞了一个TA_Lib-0.4.28-cp312-cp312-win_amd64.whl这个文件名信息量很大cp312 表示对应 CPython 3.12win_amd64 表示 Windows 64 位。也就是说作者是在 Python 3.12 Windows 环境下打包的你如果用的是 3.10 或 3.11这个 whl 装不上得自己找对应版本。TA-Lib 是技术指标计算库K 线均线、MACD 这类计算都靠它而它在 Windows 上编译一直是个老大难所以作者干脆把编译好的轮子放进来了这个细节对新手很友好。2.1 依赖清单与版本对齐先看requirements.txt这是判断项目能不能跑的第一手材料。常见做法是先建虚拟环境再装依赖避免污染全局 Python。我一般会这么做# 创建并激活虚拟环境Python 版本尽量对齐 3.12 python -m venv venv venv\Scripts\activate # 先装离线 whl再装其余依赖 pip install TA_Lib-0.4.28-cp312-cp312-win_amd64.whl pip install -r requirements.txt这里有个顺序问题TA-Lib 的 whl 必须和你的 Python 版本、系统位数严格匹配装错了会直接报 “is not a supported wheel on this platform”。先单独装它是为了在装其余依赖前就把这个最容易翻车的环节确认掉。requirements.txt里通常还会包含 akshare、pyqt5、pyqtgraph、pandas 这几个核心包akshare 负责数据pyqt5 负责界面pyqtgraph 负责高性能绘图pandas 做数据清洗。2.2 install.bat 与手动安装的取舍项目根目录有个install.bat这是给 Windows 用户准备的一键安装脚本。它的价值在于把上面那串命令固化了双击就能跑。但批处理脚本有个通病它默认你的 Python 已经加进了系统 PATH且版本正好是 3.12。如果你的机器上装了多个 Pythonpython命令指向的可能不是你想要的那个这时候 bat 会静默装到错误的解释器里后面运行主程序就报模块找不到。提示跑 install.bat 之前先在命令行执行python --version和where python确认当前指向的解释器版本和路径再决定是双击 bat 还是手动敲命令。手动安装虽然多几步但每一步的报错你都能看到出问题好定位。装完之后用一句python -c import akshare, PyQt5, pyqtgraph, talib验证四个模块都不报错环境这关就算过了。这一步别省后面界面起不来、K 线画不出很多时候根子就在依赖没装全。3. 源码结构拆解主窗口、K 线组件与数据线程怎么协作环境过了接下来要能看懂这 8 个 Python 脚本各自干什么。这套工程的结构是典型的 PyQt 桌面应用分层入口脚本、主窗口逻辑、自定义控件、数据更新线程、信号基类。理清它们的关系你才知道改功能该动哪个文件。3.1 入口与主窗口Heaven_Hand_Main.py 和 mainWindow.pyHeaven_Hand_Main.py是程序入口通常只做三件事创建 QApplication、实例化主窗口、进入事件循环。真正的界面逻辑在mainWindow.py里它负责加载mainWindow.ui、绑定按钮事件、初始化表格和图表区域。.ui文件是 Qt Designer 的可视化布局产物用 PyQt 的uic.loadUi或pyuic5转成 Python 代码后使用。# 入口脚本的典型结构负责拉起整个应用 import sys from PyQt5.QtWidgets import QApplication from mainWindow import MainWindow if __name__ __main__: app QApplication(sys.argv) window MainWindow() # 主窗口内部完成 ui 加载与信号绑定 window.show() sys.exit(app.exec_())这段代码本身不复杂关键在于MainWindow的构造过程。它一般会在__init__里调用setupUi加载界面然后连接信号槽比如“查询按钮点击 → 触发数据抓取 → 刷新表格和 K 线”。你如果想把默认股票代码改掉或者加一个自选股列表改的就是mainWindow.py里的初始化和槽函数而不是入口脚本。3.2 K 线绘制KGraph.py 与 pyqtgraphKGraph.py是这套源码里技术含量最高的部分它基于 pyqtgraph 实现 K 线图。pyqtgraph 相比 matplotlib 的优势是绘图性能高、和 Qt 集成好适合做实时刷新的行情图。K 线本质上是把每根蜡烛拆成影线和实体两部分来画影线用线段实体用矩形涨跌用红绿区分。# K 线绘制的核心思路影线 实体分层绘制 import pyqtgraph as pg from pyqtgraph import QtCore, QtGui class CandlestickItem(pg.GraphicsObject): def __init__(self, data): super().__init__() self.data data # data 每行: [时间, 开, 高, 低, 收] self.picture QtGui.QPicture() self._generate_picture() def _generate_picture(self): painter QtGui.QPainter(self.picture) w 0.3 # 蜡烛实体半宽控制视觉粗细 for t, open_, high, low, close in self.data: # 影线从最高到最低画一条竖线 painter.setPen(pg.mkPen(w)) painter.drawLine(QtCore.QPointF(t, high), QtCore.QPointF(t, low)) # 实体涨用红、跌用绿矩形高度是开收价差 if close open_: painter.setBrush(pg.mkBrush(r)) else: painter.setBrush(pg.mkBrush(g)) painter.drawRect(QtCore.QRectF(t - w, open_, w * 2, close - open_)) painter.end() def paint(self, painter, *args): painter.drawPicture(0, 0, self.picture) def boundingRect(self): return QtCore.QRectF(self.picture.boundingRect())这段代码里几个参数值得说清楚w控制蜡烛宽度调大蜡烛变胖、调小变瘦太大会互相重叠mkPen(w)是影线颜色白色在深色背景上更清晰涨红跌绿是国内习惯如果你要做成国际风格把两个颜色对调即可。boundingRect必须正确返回绘制区域否则 pyqtgraph 会裁剪掉超出部分图就显示不全这是新手最容易忽略的一处。3.3 数据更新线程ThreadUpdateWidget.py 与 BaseSignal.py行情软件不能卡界面所以数据抓取必须放到子线程。ThreadUpdateWidget.py就是干这个的它继承自 QThread在run方法里循环调用 Akshare 接口拉数据拿到后通过信号发回主线程刷新 UI。BaseSignal.py定义了自定义信号因为 Qt 的信号槽机制要求信号必须是类属性跨线程通信靠的就是它。# 子线程抓数据通过信号回传避免阻塞主界面 from PyQt5.QtCore import QThread, pyqtSignal import akshare as ak class UpdateThread(QThread): data_ready pyqtSignal(object) # 自定义信号携带 DataFrame def __init__(self, symbol): super().__init__() self.symbol symbol self._running True def run(self): while self._running: # 拉取日线行情具体接口名以 akshare 当前版本为准 df ak.stock_zh_a_hist(symbolself.symbol, perioddaily) self.data_ready.emit(df) # 发回主线程 self.msleep(5000) # 5 秒刷新一次别设太短 def stop(self): self._running False这里msleep(5000)是刷新间隔设成 5 秒是常见做法。如果你设成几百毫秒Akshare 接口扛不住高频请求轻则返回空数据重则被限流。data_ready信号携带的是 DataFrame 对象主线程收到后更新表格和 K 线。线程停止用_running标志位控制比直接 kill 线程安全退出程序前记得调用stop()再wait()否则可能报 “QThread: Destroyed while thread is still running”。4. 数据抓取与界面联动Akshare 接口调用与表格刷新看懂结构之后真正决定这套软件好不好用的是数据这一环。Akshare 是开源金融数据接口库覆盖股票、基金、期货等维度stock_zh_a_hist这类接口能直接返回历史行情。但接口调用有几个现实问题字段名会变、返回可能为空、频率有限制处理不好界面就是一片空白。4.1 Akshare 接口调用与字段处理Akshare 返回的 DataFrame 列名是中文的比如“日期”“开盘”“收盘”“最高”“最低”“成交量”。K 线绘制需要的是数值型数组所以拿到数据后通常要做一次列名映射和类型转换。import akshare as ak import pandas as pd def fetch_kline(symbol000001, perioddaily): # 拉取历史行情symbol 是不带市场前缀的 6 位代码 df ak.stock_zh_a_hist(symbolsymbol, periodperiod, adjustqfq) if df is None or df.empty: return None # 中文列名映射成绘图用的英文列名 df df.rename(columns{ 日期: date, 开盘: open, 收盘: close, 最高: high, 最低: low, 成交量: volume }) # 确保价格列是浮点型否则绘图会报类型错误 for col in [open, high, low, close]: df[col] pd.to_numeric(df[col], errorscoerce) return df[[date, open, high, low, close, volume]].dropna()adjustqfq是前复权做技术分析一般都用复权数据不然除权除息那天 K 线会出现巨大跳空指标全乱。errorscoerce把转换失败的脏数据变成 NaN再dropna()丢掉避免一根坏数据让整张图崩掉。这几步看着琐碎但少了任何一步后面画图都可能翻车。4.2 表格控件与 K 线的联动刷新MyTableWidget.py是自定义表格控件负责展示股票列表或行情明细。界面联动的逻辑是用户在表格里选中某只股票 → 主窗口捕获选中事件 → 用该股票代码启动或更新数据线程 → 线程回传数据 → 刷新 K 线组件。这条链路里信号槽的连接方式决定了响应是否及时。环节涉及文件关键动作选中股票MyTableWidget.py发出当前行代码信号接收并分发mainWindow.py连接信号到刷新槽函数拉取数据ThreadUpdateWidget.py子线程调用 Akshare绘制 K 线KGraph.py更新 CandlestickItem 数据表格刷新时要注意一点频繁setRowCount和逐格setItem在数据量大时很卡。常见优化是先setUpdatesEnabled(False)批量填完再setUpdatesEnabled(True)或者直接用QAbstractTableModel配QTableView。这套源码用的是 QTableWidget 路线数据量不大时够用但你要拿它跑全市场几千只股票就得换成 model/view 架构否则界面会明显发顿。5. 避坑与常见问题排查从模块导入失败到 K 线不显示这套源码我拆下来翻车点集中在环境、接口、绘图三块。下面几条都是实际会遇到的按“现象 → 原因 → 解决”记一遍能省不少时间。现象一ModuleNotFoundError: No module named talib。原因基本是 TA-Lib 的 whl 没装成功或者装到了另一个 Python 解释器里。解决先pip show TA_Lib确认是否装上再看where python和pip -V指向是否一致。版本不匹配就去找对应 cp 版本的 whl别硬用源码编译Windows 上编译 TA-Lib 要装 C 编译器成本太高。现象二界面能起来但 K 线区域一片空白。常见原因是数据没拿到或格式不对。先在fetch_kline里print(df.head())确认返回非空、列名映射正确、价格列是数值型。另一个可能是boundingRect返回的区域不对pyqtgraph 把图形裁掉了检查它是否覆盖了所有蜡烛的坐标范围。现象三程序关闭时报QThread: Destroyed while thread is still running。原因是窗口关闭时子线程还在循环。解决重写主窗口的closeEvent在里面调用线程的stop()再wait()等线程真正退出再关闭窗口。现象四Akshare 接口偶尔返回空或超时。这是接口本身的网络波动不是代码 bug。解决加一层重试和异常捕获失败时保留上一次的数据而不是清空界面同时把刷新间隔调大一点别把接口当本地数据库用。现象五.ui文件改了但界面没变化。如果你用的是pyuic5生成 Python 代码的方式改完 .ui 必须重新生成如果用uic.loadUi直接加载 .ui则要确认加载的是最新文件路径。两种方式别混用否则改了不生效会让人怀疑人生。6. 二次开发技巧把演示骨架改成你自己的看板跑通之后这套源码真正的价值在于它是个能改的骨架。演示视频上帝之手股票分析软件演示.mp4能让你快速看到原始功能但你要做自己的看板得知道从哪下手。最实用的一个改造方向是加均线在 K 线基础上叠加 MA5、MA10、MA20这是技术分析里最基础的组合。import pyqtgraph as pg def add_ma(plot_widget, df, windows(5, 10, 20)): # 用收盘价滚动平均算均线window 就是周期 for w in windows: ma df[close].rolling(windoww).mean() # 时间轴用索引代替日期避免日期字符串无法直接绘图 plot_widget.plot(list(range(len(ma))), ma.values, penpg.mkPen(width1.5), namefMA{w})rolling(windoww).mean()是均线计算的核心window就是周期参数改成 30、60 就是月线和季线。注意这里横轴用的是索引而不是日期因为 pyqtgraph 对字符串日期支持不友好常见做法是把日期转成序号再用AxisItem自定义刻度显示日期文本。均线加完你还可以接着加成交量副图、MACD 子图思路都是新建一个 PlotWidget 然后setXLink把横轴和主图联动。另一个改造点是数据源。现在用的是 Akshare 的日线接口如果你想做分钟级把period改成min或对应参数即可但要注意分钟数据接口的返回字段和频率限制跟日线不一样得单独测。我一般改完接口会先单独写个脚本验证返回结构确认没问题再往界面里接不然界面报错信息被 Qt 吞掉排查起来很费劲。从那以后我每次拿到这类 PyQt 数据接口的源码都强制先单独跑通数据层再动界面层两层分开验证出问题能立刻定位是哪一层的锅。这套上帝之手源码结构清晰、依赖给得实在作为金融桌面应用的入门骨架是够格的剩下的就看你往里填什么了。希望帮到你。本文还有配套的精品资源点击获取