# 微信公众号文章图片批量下载
一个 Tampermonkey 用户脚本,用于在微信公众号文章页批量下载正文图片、GIF,以及“图文”模式左右滑动轮播中的图片。
## 安装
1. 安装 Tampermonkey 浏览器扩展。
2. 新建脚本,将 [`wechat-article-image-downloader.user.js`](./wechat-article-image-downloader.user.js) 全部内容粘贴进去并保存。
3. 打开 `https://mp.weixin.qq.com/s/...` 文章页,页面右下角会出现“文章图片下载”面板。
4. 点击“下载全部图片 / GIF”。脚本会在浏览器下载目录下创建以文章标题命名的文件夹,图片和 `info.txt` 都放在该文件夹内。浏览器可能会询问是否允许此站点批量下载,请允许。
5. 如果 Tampermonkey 提示文件扩展名未获准,在扩展设置中允许 `txt`、`jpg`、`png`、`gif`、`webp`、`bmp` 文件类型。
## 图片地址与文件名
普通文章图片按 `data-croporisrc`、`data-src`、`data-original`、`data-lazy-src`、`src` 的顺序读取地址。图文轮播模式会额外读取 `.swiper_item[data-src]`;该容器地址优先于子级 `
`,因为后者可能是 `tp=webp` 预览图。对 `mmbiz.qpic.cn` 地址,脚本会将路径中的 `/640` 改为微信常见的原图路径 `/0`,并清除 `tp=webp` 等页面预览参数;图片格式从 `wx_fmt` 或图片元素的 `data-type` 推断。因此 GIF 按 `.gif` 下载,不会被页面的 WebP 预览地址变成静态图。
文件名使用“文章标题_序号.扩展名”,例如 `大肥鱼表情包_001.gif`。重复地址只下载一次。页面动态加载或轮播切换后新发现的地址会加入本次图片列表。
每次批量下载会生成 `info.txt`,记录文章标题、当前文章链接、导出时间,以及每张图片的文件名、源地址和下载结果。文件夹和文件名会清理 Windows 不支持的字符。
## 使用边界
- 页面里已经加载或写入 DOM 的正文图片和轮播项会被扫描;动态插入或轮播切换后新发现的图片会在面板计数刷新时纳入。
- 微信 CDN 的地址规则可能变化;如果个别图片下载失败,可检查浏览器控制台和 Tampermonkey 的下载权限。
- `info.txt` 通过 Tampermonkey 的 Blob 下载接口生成;请使用支持 Blob 下载的 Tampermonkey 版本(5.4.6226 或更新版本)。
- 脚本处理文章正文中的 `
` 和 `.swiper_item[data-src]`,不处理视频封面、CSS 背景图或文章内嵌的其他文件。若轮播采用虚拟列表,只将当前页放入 DOM,建议先左右浏览一次各页,让脚本发现其图片地址。