企业官网建设流程全解析

QQ空间历史说说导出指南：5分钟用 GetQzonehistory 存下你的空间记录

【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory

你有没有想过，把 QQ 空间里攒了多年的说说、转发、留言一次全部搬下来？GetQzonehistory 是一个 Python 小工具：你用手机 QQ 扫个码，它就自动把空间历史消息列表翻完，整理成 Excel 表格加一个仿网页版 HTML。不用你写任何代码，跟着下面的步骤走，十几分钟就能拿到自己的存档包。

快速上手：从克隆到跑通

整个过程按顺序敲 6 行命令就行：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory

把项目下载到你电脑上。

cd GetQzonehistory

进入项目目录。

python -m venv myenv

建一个独立的虚拟环境，避免污染你自己机器上已有的 Python 库（Windows 也可以直接用本机环境，但虚拟环境更省心）。

source myenv/bin/activate

激活这个环境，Windows 下改成myenv\Scripts\activate。

pip install -i https://mirrors.aliyun.com/pypi/simple/ -r requirements.txt

安装项目列出的全部依赖，走国内镜像会快很多。

python main.py

启动程序，终端里会打印出一个登录二维码，打开手机 QQ 扫码。之后程序会自动翻页抓取，你只需要等。

有一点要提前知道：登录用到了pyzbar这个包，它依赖系统里的 zbar 共享库。如果你的机器上没装，启动时会直接提示你缺什么，Linux 上装个zbar（dnf install -y zbar或apt-get install zbar），macOS 上brew install zbar即可，程序会给出对应的提示。

它能帮你解决什么

把散落的旧记录收拢成档案。你不需要一页页翻空间手动截图，它从空间的消息列表接口批量拉取互动记录，每 10 条一批、批与批之间歇 3 秒，上千条记录也能翻完。

把"你的内容"和"别人给你的内容"分开。抓回来的记录会被自动分类：你自己发的说说、你转发的内容、别人留下的留言、其他互动，各归各的表，不用再手动筛选。

补上消息列表看不到的部分。消息列表里不一定有你全部的可见说说，项目里专门写了 util/GetAllMomentsUtil.py 去拉取未删除的可见说说，和消息列表的数据去重后合并，存档会更完整。

连老相册一起存。程序会下载说说里带图片的高清版本（它会把缩略图链接替换成大图链接），统一放进本地目录。

你会拿到什么

跑完之后，程序会在resource/result/下建一个以你 QQ 号命名的文件夹，里面是这些东西：

• {QQ号}_全部列表.xlsx：所有抓到的记录，字段是时间、内容、图片链接、评论
• {QQ号}_说说列表.xlsx：只含你本人发的说说
• {QQ号}_转发列表.xlsx：你转发的内容
• {QQ号}_留言列表.xlsx：别人给你留下的留言
• {QQ号}_其他列表.xlsx：不属于以上三类的互动
• {QQ号}_好友列表.xlsx：出现过的互动好友（昵称、QQ、主页链接）
• {QQ号}_说说网页版.html：把说说和转发按时间排好、还原成接近空间原貌的页面，浏览器打开就能翻看
• pic/子目录：下载下来的全部图片

另外还有一个独立入口 fetch_all_message.py，它会专门抓取"全部可见未删除的说说"（可以追溯到很早年），输出成一份所有可见说说.md的 Markdown 文档加对应图片，适合你想要纯文本备份的时候用。

它是怎么做到的

不用看代码也能理解它的分工。util/LoginUtil.py 负责登录：生成二维码、验证扫码结果、把登录凭证存到resource/user/本地目录，之后再次运行可以选上次登录的账号，不必重复扫码。util/RequestUtil.py 负责网络：模拟浏览器请求空间接口，处理分页参数和返回内容。util/ToolsUtil.py 负责脏活：解析返回的 HTML、清洗特殊字符、把 QQ 表情标记还原成图片。util/ConfigUtil.py 读取配置，决定文件存到哪里。最后 main.py 当总调度：登录 → 逐批抓消息 → 合并可见说说 → 分类落盘 → 生成网页版，一条龙走完。

让它跑得更好的技巧

1. 优先用虚拟环境 + 国内镜像，依赖版本都锁在 requirements.txt 里，装错了也容易排查。
2. 导出目录给够空间。pic/里存的是原图，几年的记录攒下来可能有好几个 GB，建议导出完就同步一份到移动硬盘或网盘。
3. 让它跑完。每批之间有 3 秒停顿，记录多的账号整个过程要十几分钟甚至更久，中途关窗口只会留下半成品。
4. 网络不稳就换个环境。抓取是连续分页请求，弱网下某批失败会直接跳过，换个稳定的网络重跑更省事。

遇到问题怎么办

现象：启动时报"无法找到 zbar 共享库"。原因：pyzbar需要系统级的 zbar 库，pip 装的是 Python 部分。 解法：Linux 用包管理器装zbar，macOS 用brew install zbar，程序本身会在终端打印对应系统的安装命令，照着做即可。

现象：扫码后登录失败或二维码失效。原因：网络访问不了空间网页，或者二维码超时。 解法：重新运行python main.py生成新码再扫；顺便确认电脑时间没有偏差，时间不准也会导致登录校验失败。

现象：导出的条数比印象里少。原因：工具能拿到的只是"可见"的记录——仅自己可见的说说、已删除的内容不会出现在消息列表里，这是抓取机制的边界，不是漏抓。 解法：可以再跑一次 fetch_all_message.py 补齐可见说说，两份数据对照着看。

现象：部分图片下载失败。原因：早期图片的原链接可能已经失效。 解法：属于正常情况，能下下来的部分不受影响，不需要反复重跑。

现象：中途想停。原因：你按了Ctrl+C。 解法：不用慌，程序注册了中断处理，已抓到的数据会先落盘再退出，下次重跑即可。

写在最后

GetQzonehistory 做的事情其实很朴素：扫码登录、翻页抓取、分类导出，没有多余的东西。它的价值在于把一次性的体力活变成可重复的流程——今天存一份，明年可以再存一份，旧数据和新数据都握在自己手里。如果你的空间里还留着那些舍不得删的旧记录，不妨找个晚上花十分钟跑一次，先把那份属于自己的存档拿下来。

【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory