三步导出QQ空间全部历史说说：免费开源工具完整教程
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
朋友发我一张六年前说说的截图，我愣了半天——翻QQ空间首页，最近几年的动态还能看到，再往前的就彻底找不着了。GetQzonehistory 是一个免费开源的 Python 工具，专门做QQ空间历史说说导出：扫码登录后，它把旧说说一条条挖出来，整理成本地 Excel 表格和图片，让平台里埋着的旧记忆变成你能长期保存的文件。
先把它跑起来
从克隆到终端弹出二维码，一个命令行全搞定。我在 Python 3.12 下跑的，装完依赖到二维码出现，前后不到 5 分钟。
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory python -m venv myenv source myenv/bin/activate pip install -r requirements.txt python main.py- 克隆仓库并进入目录——把代码放到你以后找得到的位置。
- 建虚拟环境并激活——隔离依赖，免得和电脑上其他软件打架。
- 装依赖——requirements.txt 里的 11 个包版本全部钉死，不会出现冲突。
- 运行 main.py——终端画出登录二维码，手机 QQ 扫一下即可，全程不输密码，随后进度条开始滚动。
一个坑我踩了：首跑提示缺少 zbar 共享库，那是系统级的二维码解码库，要单独装。Linux 执行sudo dnf install -y zbar，macOS 执行brew install zbar，装完再跑就通了。实在不想碰 Python 环境的，项目 release 页有打包好的单文件版本。
它到底做了什么
白话讲一遍。所有请求都由你的电脑直连QQ空间官方接口，不经过任何第三方中转。
第一步登录。util/LoginUtil.py 直接在终端画出二维码，手机扫一下，登录凭证就到手了，不需要输入密码。
第二步抓取，分两路。主路在 main.py 里翻历史消息列表，每批 10 条、批间停 3 秒，进度条实时可见；辅路走 util/GetAllMomentsUtil.py，按每页 30 条抓全部可见的未删除说说——代码注释写明包含 2014 年之前的——补上消息列表漏掉的部分。
第三步整理。两路数据按内容比对去重，再按"谁说的、干了什么"拆进说说、转发、留言等表格，图片逐张存进 pic/，顺手把说说和评论拼成一个仿空间网页。请求解析的细节在 util/RequestUtil.py 和 util/ToolsUtil.py 里，想审查逻辑直接打开看。
最后落在硬盘上的东西
进度条跑完后，终端依次打印最早一条说说的时间和各列表条数，再自动打开对应文件夹。所有产物都在resource/result/目录下，按 QQ 号分了子目录。
📦 产物清单：
QQ号_全部列表.xlsx：最全的一张表，时间、内容、图片链接、评论四列QQ号_说说列表.xlsx：只收你自己发布的说说QQ号_转发列表.xlsx：你做过的转发记录QQ号_留言列表.xlsx：好友留在你空间的评论QQ号_其他列表.xlsx：其他好友的动态，和你的发布区分开QQ号_好友列表.xlsx：出现在消息列表里的好友名单，含昵称、QQ号、空间主页QQ号_说说网页版.html：把说说和评论拼成仿空间样式的网页，浏览器打开就能看pic/子文件夹：说说里的全部图片，按说说内容命名，特殊字符与重名自动处理，文件名上限 40 个字符
为什么需要它
- 首页只显示近年的说说 → 它按每批 10 条翻历史消息列表，把更早的也挖出来
- 担心说说里的图片会失效 → 每张图单独下到本地文件夹，表格里同时记着链接
- 还想连好友互动一起留 → 本人说说、转发、留言、其他好友分表整理，再附一个网页
边界与坑：先知道这几件事
⚠️ 不是所有说说都能拿到。边界就是历史消息列表：当年设了私密、从未出现在消息列表里的说说拿不到，第二路也仅限"没被删除"的。想留存的记忆宜早不宜晚。
⚠️ 时间与磁盘要有预期。速度受间隔机制限制，历史消息超过两千条的话，十分钟以内别期待跑完；图片逐张下载，图多的账号留出 1GB 以上空闲。中途要离开按 Ctrl+C，已抓到的部分同样会写入磁盘。
⚠️ 扫码登录安全吗，不用太担心。它走官方扫码通道，密码不经过任何程序，数据全程在本机处理和本机存放，不上传任何服务器。再不放心的话，先把源码读一遍再运行，代码开源可自行审查。
还能怎么玩
第二个入口 fetch_all_message.py。执行python fetch_all_message.py，它抓全部可见的未删除说说（包含 2014 年之前的），输出一个所有可见说说.md，图片存到resource/fetch-all/目录。比起 Excel，这份 Markdown 更适合当时间线从头读到尾。
二是把导出的数据再用起来。我认识一位做个人年度复盘的朋友：每年年底按年份筛选"说说列表"那张表，挑出三条最满意的，配几张 pic/ 里的图，做成图文小结。HTML 网页版稍微改改样式，就是能发给老同学的电子纪念册。
✅ 行动清单：
- ✅ 克隆仓库进入目录，执行
pip install -r requirements.txt - ✅ 运行
python main.py，QQ 扫码登录，等进度条走完 - ✅ 打开 result 目录，把对应 QQ 号的 Excel 和 pic/ 文件夹归档
当年写下的那些说说没有消失，只是还留在平台上等你接回来——宜早不宜晚。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
