简介WechatMoments v0.0.1便携版是一款专为Windows平台设计的微信朋友圈数据导出工具面向普通用户、数字存档爱好者及轻量级数据管理者解决微信原生不支持朋友圈内容本地化保存的痛点。它可将已在电脑端微信浏览过的朋友圈动态批量导出为结构清晰的HTML页面并同步下载关联图片与视频支持按联系人、发布时间范围进行精准过滤实现离线查阅与永久归档。资源包共2000个文件主体为1014个dat缓存数据、127个msg消息记录、44个pyd及41个dll核心运行模块辅以少量py脚本、CSS/JS前端资源和多时区tzdata文件如asia/shanghai、america/new_york等整体体积127.75MB解压即用。目前已有639人下载学习提供完整可执行流程从微信登录准备、管理员运行到异常处理提示无需编程基础适合希望自主掌控社交数据主权的进阶个人用户。1. 微信朋友圈导出工具 WechatMoments v0.0.1便携版别急着点“导出”先看清这三道门坎你是不是也试过花半小时下载了某个标着“一键导出朋友圈”的工具双击运行后弹出黑窗口闪退、提示“缺少 MSVCP140.dll”、或者刚扫完微信二维码就卡死在“正在获取数据…”这不是你电脑不行而是 WechatMoments v0.0.1 这个便携版——它压根没打包运行时依赖也不自带微信协议适配层更不处理新版微信 Android 客户端8.0.50强制启用的设备指纹校验。它是一份“半成品交付物”核心逻辑完整但默认只对 Windows 10/11 微信 PC 版 3.9.5.26 ~ 3.9.8.17 区间版本友好超出这个范围不是报错就是漏数据。它适合谁适合有基础命令行操作能力、愿意手动补依赖、能接受导出内容不含视频原文件仅保留链接、且明确知道“导出≠备份全部原始媒体”的开发者或数字存档需求者。如果你只想拖拽一个 exe 就导出带图带文字的 HTML 页面那它会给你上一课什么叫“便携版的代价”。2. 环境准备与依赖安装WechatMoments 不是绿色软件它只是没打包进安装器WechatMoments v0.0.1 便携版本质是一个 Python 脚本集合主入口为main.py外加预编译的wechat_moments_core.dll用于绕过部分微信 Web 协议加密。它不提供.exe封装所谓“便携”是指无需管理员权限安装但必须手动满足底层运行环境。下面分三步走确认系统基线、安装 Python 运行时、补全关键 DLL。2.1 确认 Windows 系统与微信 PC 版版本兼容性WechatMoments v0.0.1 的协议解析模块基于微信 PC 版 3.9.x 的 Web 微信通信链路逆向。实测中以下组合可稳定完成登录与图文抓取微信 PC 版本Windows 系统是否推荐原因说明3.9.5.26Win10 22H2 / Win11 23H2✅ 强烈推荐协议字段最稳定二维码扫描成功率 95%图文混排解析无错位3.9.7.23Win10 21H2⚠️ 可用但需降级浏览器内核需手动修改config.json中browser_engine: edge→chromium否则部分富文本节点丢失3.9.8.17Win11 24H2❌ 不建议微信强制注入weapp://协议拦截导致get_moments_list接口返回空数组提示检查当前微信版本方法打开微信 PC 版 → 左下角「三条横线」→「设置」→「关于微信」→ 查看右下角版本号。若高于 3.9.8.17请从微信官网历史版本页下载 3.9.7.23 安装包文件名形如WeChatSetup-3.9.7.23.exe不要覆盖安装先卸载当前版再装旧版——新版残留注册表项会导致旧版无法启动。2.2 安装 Python 3.9.13唯一验证通过的运行时WechatMoments v0.0.1 的requirements.txt显式声明依赖pywin32305、requests2.28.2、lxml4.9.2而这些包在 Python 3.10 上存在 ABI 兼容问题尤其lxml编译时链接的libxml2版本冲突。血泪经验用 Python 3.9.13 是目前唯一能跳过编译环节、直接pip install -r requirements.txt全通的版本。# 下载 Python 3.9.13 embeddable zip官方便携版免安装 # 地址https://www.python.org/ftp/python/3.9.13/python-3.9.13-embed-amd64.zip # 解压到任意路径例如D:\python39 # 进入解压目录执行初始化生成 python39._pth 并取消注释 import site cd D:\python39 .\python.exe -c import sys; print(sys.path) # 若报错“ModuleNotFoundError: No module named site”则编辑 python39._pth # 删除第2行开头的 # 号保存后重试2.3 补全 Visual C 运行时与 OpenSSL DLLWechatMoments 的wechat_moments_core.dll是用 Visual Studio 2019 编译的依赖vcruntime140.dll和msvcp140.dll同时其 HTTPS 请求模块硬编码调用libssl-1_1-x64.dll。这两个 DLL不会随便找系统路径必须放在 WechatMoments 主目录下。# 步骤1安装 Microsoft Visual C 2015–2019 Redistributablex64 # 下载地址https://aka.ms/vs/16/release/vc_redist.x64.exe # 运行安装重启电脑确保系统级 DLL 注册 # 步骤2手动复制 OpenSSL DLL 到 WechatMoments 根目录 # 从 Python 3.9.13 embeddable zip 中提取 # \python-3.9.13-embed-amd64\python39.dll → 重命名为 libssl-1_1-x64.dll # 注意不是 libssl-3-x64.dllv0.0.1 不支持 OpenSSL 3.x # 将该文件复制到 WechatMoments 文件夹根目录与 main.py 同级参数说明为什么必须用libssl-1_1-x64.dll因为 WechatMoments 的核心 DLL 在加载时硬编码调用SSL_CTX_new符号该符号在 OpenSSL 1.1.x 中为libssl-1_1-x64.dll导出在 OpenSSL 3.x 中已改为libssl-3-x64.dll且函数签名变更。强行替换会导致OSError: [WinError 126] 找不到指定模块。3. 工具配置与启动三个配置文件决定你能导出什么WechatMoments v0.0.1 的行为由三个 JSON 配置文件控制config.json全局策略、filter.json内容筛选、output.json导出格式。它们不在同一层级且顺序不能错——先改config.json再动其他。3.1config.json控制登录方式与协议通道该文件位于WechatMoments\config\config.json关键字段如下{ login_method: qrcode, browser_engine: chromium, wechat_path: C:\\Program Files (x86)\\Tencent\\WeChat\\WeChat.exe, timeout_seconds: 120, max_retries: 3 }login_method: qrcode必须设为qrcode。web模式已被微信废弃hook模式需额外驱动权限v0.0.1 未实现。browser_engine: chromium指定内置 Chromium 内核版本v88。若设为edge则调用系统 Edge但新版 Edge 默认启用 Strict CSP会拦截window.open(weapp://)导致登录中断。wechat_path必须指向你已降级安装的微信 PC 版可执行文件如WeChat.exe而非快捷方式。路径含空格需用双反斜杠转义。3.2filter.json定义朋友圈内容抓取边界该文件控制“导出哪些人、哪些时间、哪些类型”。v0.0.1 支持按昵称模糊匹配、按发布时间区间、按内容类型纯文字/图文/视频链接过滤{ nickname_keywords: [张三, 李四], date_range: { start: 2023-01-01, end: 2024-06-30 }, content_types: [text, image] }nickname_keywords填入你想导出的朋友昵称非微信号支持中文、英文、emoji。注意若昵称含特殊字符如、/需用 Unicode 转义如→\u0040。content_typesvideo类型仅导出视频播放页 URL形如https://mp.weixin.qq.com/mp/readtemplate?...不下载 MP4 文件。这是设计限制非 bug。3.3output.json决定最终产物结构该文件定义导出目标格式、文件命名规则、HTML 模板路径{ format: html, output_dir: D:\\wechat_export, filename_template: {nickname}_{date:%Y%m%d_%H%M%S}, template_path: templates\\default.html }format仅支持html和json。markdown在 v0.0.1 中未实现强行设置会静默回退为html。output_dir必须为绝对路径且该路径需提前创建好。WechatMoments 不会自动建目录路径不存在将导致OSError: [Errno 2] No such file or directory。template_path模板文件必须放在WechatMoments\templates\下且default.html中的{content}占位符不可删除否则导出 HTML 为空白页。常见做法是导出前先用output.json中的format: json跑一次小范围测试如只设 1 个昵称 1 天范围确认 JSON 数据结构正确后再切回html。这样可避免 HTML 渲染失败却不知是数据问题还是模板问题。4. 启动与执行用 PowerShell 替代双击让错误可见WechatMoments v0.0.1 没有图形界面双击main.py会闪退——因为 Python embeddable 版默认不关联.py文件且错误日志不输出到桌面。必须用 PowerShell 或 CMD 显式调用并重定向日志便于排查。4.1 启动前必做设置 PYTHONPATH 与临时目录WechatMoments 的日志模块依赖os.getenv(TEMP)写入 debug.log而某些企业环境会锁定 TEMP 目录。需手动指定# 以管理员身份打开 PowerShell仅首次需要 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # 进入 WechatMoments 根目录 cd D:\WechatMoments # 设置环境变量临时生效当前窗口有效 $env:PYTHONPATHD:\python39 $env:TEMPD:\WechatMoments\temp $env:TMPD:\WechatMoments\temp # 创建 temp 目录 mkdir temp4.2 执行主程序并捕获完整日志# 方式1带详细日志推荐首次运行 D:\python39\python.exe main.py --debug run_debug.log 21 # 方式2静默运行确认流程稳定后 D:\python39\python.exe main.py run.log 21--debug参数会开启logging.DEBUG级别输出每一步 HTTP 请求 URL、响应状态码、DOM 解析 XPath 表达式。若卡在“正在获取朋友圈列表”日志里会显示GET https://szfile.wx.qq.com/xxx?uin...及其返回的{ret: -2001}错误码含义设备未授权。 run_debug.log 21将标准输出与错误输出合并写入日志文件方便全文搜索关键词如qrcode、moments_list、SSL。4.3 登录过程中的关键交互点WechatMoments 启动后会自动拉起微信 PC 版并在右下角弹出二维码窗口。此时需注意三点不要手动点击微信内的“登录网页版”WechatMoments 已接管协议手动点会导致微信认为“重复登录”返回ret-2002。二维码 2 分钟失效若超时未扫程序会自动刷新但刷新次数上限为 3 次由config.json中max_retries控制。扫码后微信客户端无反应检查微信设置 → 通用设置 → 关闭「接收新消息通知」和「语音视频通话提醒」——这两项开启时微信会阻塞后台协议回调。我一般会在扫码前先执行Get-Process -Name WeChat | Stop-Process -Force杀掉所有微信进程再运行main.py。这样能确保微信以 clean state 启动避免旧会话残留干扰协议握手。5. 常见问题与避坑指南那些让你怀疑人生却只需改一行的错误WechatMoments v0.0.1 的报错信息极其简陋很多问题表面看是网络错误实则是配置或环境错位。以下是实测中最高频的 5 类问题按现象→原因→解决结构整理每一条都来自真实翻车现场。5.1 现象黑窗口闪退无任何日志原因Python embeddable 版未正确初始化site模块导致import requests失败但错误被try/except吞掉。解决进入D:\python39目录用记事本打开python39._pth删掉第二行开头的#号即取消import site的注释保存后重试。5.2 现象日志中反复出现OSError: [WinError 126] 找不到指定模块原因wechat_moments_core.dll依赖的libssl-1_1-x64.dll不在当前目录或版本不匹配如放了 OpenSSL 3.x 的 DLL。解决确认WechatMoments\根目录下存在libssl-1_1-x64.dll文件大小应为 3.21 MB且不是从其他项目拷贝的同名文件。可使用Dependency Walker工具打开该 DLL检查是否导出SSL_CTX_new符号。5.3 现象扫码成功但卡在Getting moments list...超过 5 分钟原因微信 PC 版版本过高≥3.9.8.17其新增的设备指纹校验机制拒绝 WechatMoments 的请求头。解决卸载当前微信从官网下载WeChatSetup-3.9.7.23.exe并安装。安装后不要打开微信直接运行main.py。5.4 现象导出的 HTML 页面中图片显示为红叉链接为data:image/png;base64,xxx原因filter.json中content_types未包含image或config.json中browser_engine设为edge导致 base64 解码失败。解决检查filter.json确保image在数组中将config.json中browser_engine改为chromium删除WechatMoments\temp\下所有缓存文件后重试。5.5 现象JSON 导出文件中media_url字段为空但朋友圈实际有图原因WechatMoments v0.0.1 的 DOM 解析 XPath 写死为//div[classimg]//img/data-src而新版微信 PC 版已改为//div[contains(class,image)]//img/src。解决编辑WechatMoments\src\parser.py找到第 87 行xpath //div[classimg]//img/data-src改为xpath //div[contains(class,image)]//img/src保存后重试。注意parser.py是唯一需要手动修改的源码文件其他模块均经过混淆。改完务必用python -m py_compile parser.py验证语法无误否则main.py会直接报SyntaxError。6. 验证导出结果与数据完整性别只看 HTML 是否打开要查三处硬指标导出完成后别急着关机。WechatMoments v0.0.1 的“成功”只是流程跑通不代表数据完整。我每次都会用以下三步交叉验证缺一不可——这是从某跨平台系统存档项目里摔出来的后悔药。6.1 检查output.json中output_dir下的文件结构WechatMoments 的 HTML 导出严格遵循filename_template规则且每个用户独立一个 HTML 文件。正确结构应为D:\wechat_export\ ├── 张三_20231225_143022.html ├── 张三_20240115_091245.html ├── 李四_20231103_164511.html └── export_summary.json ← 自动生成的汇总文件export_summary.json是关键证据它记录本次导出的总条数、各用户条数、失败条数。打开它搜索failed_count若大于 0说明有内容未抓取成功通常是网络抖动或微信限流。若发现文件名中日期为19700101说明parser.py中的时间提取 XPath 错误需回查第 112 行re.search(r(\d{4}-\d{2}-\d{2}), ...)的正则是否匹配到实际 DOM 中的日期字符串。6.2 抽样比对 HTML 中的图文与微信客户端实时内容随机打开一个 HTML 文件选取其中 3 条内容首条、中间条、末条在微信 PC 版中找到对应朋友圈逐项核对核对项正确表现错误表现原因定位发布时间2023-12-25 14:301970-01-01 08:00parser.py时间正则失效文字内容完整显示换行符转br截断在第 200 字无省略提示config.json中max_text_length未设或设为 0图片数量与微信中一致如 3 张只显示 1 张其余为占位符filter.json中content_types缺image技巧用 VS Code 打开 HTML按CtrlF搜索srcdata:统计出现次数再在微信中数同一条朋友圈的图片数。两者不等立即停用当前配置回退到 JSON 模式重跑。6.3 验证export_summary.json中的元数据一致性该文件不仅记录数量还包含每条朋友圈的moment_id微信内部 ID和timestamp毫秒时间戳。用 Excel 打开它做两件事排序去重检查按moment_id排序检查是否有重复 ID说明同一条朋友圈被拉取两次可能是max_retries过高导致重试污染时间跨度验证用公式TEXT(A2/1000,yyyy-mm-dd hh:mm:ss)将timestamp转为可读时间确认最大值与最小值之差是否符合filter.json中设定的date_range。若发现export_summary.json中total_count为 127但 HTML 文件只有 120 个说明有 7 条因图片加载失败被跳过——此时应检查WechatMoments\temp\error.log里面会记录具体哪几条moment_id的media_url获取返回 403。从那以后我每次导出前都强制走一遍D:\python39\python.exe main.py --debug precheck.log 21只扫一个好友、只取一天数据确认precheck.log末尾出现Export completed. Total: X items.且export_summary.json中failed_count为 0才开始正式批量导出。这套动作多花 3 分钟但能避免 3 小时后发现导出全废。希望帮到你。本文还有配套的精品资源点击获取