小红书图片格式转换一次讲透：6种下载格式怎么选，采集图片即下即用

小红书图片格式转换一次讲透：6种下载格式怎么选，采集图片即下即用

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader

如果你常年和小红书图片格式转换打交道，下面三个场景里大概率有一个是你的翻版。

兼职修图的大学生阿哲，接了个美妆博主的批量精修单，素材拷到电脑才发现全是 HEIC，PS 打不开、手机看图软件也不认，一单差点黄在格式上；电商运营林姐更头疼，客户拍板只要 JPG 素材，可平台扒下来的图清一色 WEBP，她每天下午都要手动转几十张图，机械劳动做到手酸；独立设计师老周则相反，他做海报需要透明背景的 PNG，下载时默认给的格式却总不是自己想要的，还得二次加工。

三个人踩的是同一个坑：图片格式不可控。而 XHS-Downloader 这个开源的小红书采集工具，把格式选择权交还给了你——下载的那一刻，就能直接拿到想要的格式。

读完这篇文章，你将掌握：

📌 6 种图片格式的取舍速览，30 秒内对号入座 📌 代码、命令行、图形界面三条最短上手路径 📌 "下载即转换"的原理，从此告别二次转码 📌 格式转换失败时的 3 个排查步骤，不再瞎折腾

一、先看清全局：6 种下载格式到底怎么选

XHS-Downloader 支持 6 种图片格式，覆盖了从"最通用"到"最前沿"的所有需求：

需要说明的是，项目默认的图片格式是 JPEG（配置见 source/module/settings.py），对大多数人来说这个默认值已经足够稳妥，不必急着改。

原理只需一句话：这不是"下载后再转码"，而是"下单时点菜"。打开 source/application/image.py 里的get_image_link就能看到，工具在生成下载链接时，就把你选的格式拼进了图片服务器的 URL 参数（比如imageView2/format/jpeg），图片服务端直接按你的要求出图。选 AUTO 则走原始 CDN 链接，原图什么样就下载什么样。所以整个流程里根本不存在"二次转换"这一步，效率自然高。

二、三条最短上手路径，按你的身份对号入座

1. 开发者：一个参数搞定，参考 example.py 即可

如果你是做二次开发，实例化XHS类时传一个image_format参数就够了：

from source import XHS async with XHS( image_format="JPEG", # 下载时直接输出 JPEG，无需二次转码 cookie="你的Cookie", # 小红书网页版 Cookie ) as xhs: await xhs.extract("https://www.xiaohongshu.com/explore/XXX", download=True)

项目根目录的 example.py 第 25 行附近，把image_format的取值都注释出来了：AUTO、PNG、WEBP、JPEG、HEIC，照着改一行就能切换格式，是开发者最省事的参考模板。

2. 命令行用户：一条命令，格式随你点

不想写代码的话，命令行是最直接的方式。下载的同时指定 JPEG 格式：

python main.py --image_format JPEG "https://www.xiaohongshu.com/explore/XXX"

嫌长可以缩写成-if，-if WEBP、-if HEIC都是合法写法。所有可用参数在程序里输入--help就能看到完整说明，其中--image_format (-if)一行明明白白写着支持的格式范围，不会让你猜：

3. 图形界面用户（推荐）：TUI 设置面板，上下键就搞定

普通用户最省心的是走 TUI 图形界面，全程键盘导航，无需记忆任何参数。进入"程序设置"后，找到"图片下载格式"下拉框，选中你要的格式，保存配置即可：

1. 启动程序进入主界面，选择"程序设置"
2. 在设置面板中定位到"图片下载格式"
3. 按上下键在 HEIC、PNG、WEBP、JPEG、AUTO 等选项中切换
4. 确认选择后保存配置，退出设置
5. 之后所有下载都按新格式执行

下面这张截图就是 TUI 设置界面的实拍，"图片下载格式"下拉框正停留在 HEIC 选项上：

三、三个高频卡点，这样排查最快

卡点 1：想换格式，需要重新下载吗？

需要，但只用重下图片，不用重新解析作品数据。因为格式是在生成链接时决定的，已经下载到本地的 HEIC 文件不会"变身"成 JPG。想换格式就把链接重新跑一遍，全程自动，比手动转码快得多。下图展示了监听剪贴板模式下，HEIC 文件直接落盘的过程，说明格式从下载源头就已确定：

卡点 2：参数写对了，为什么下载还是失败？

按这个顺序排查：先确认网络能正常访问图片服务器（必要时设置代理）；再检查 Cookie 是否过期，Cookie 失效是采集类工具最常遇到的坑；最后看请求超时时间和最大重试次数是否设置得太小。程序根目录的 logs 文件夹里留有详细错误日志，卡住时先翻日志，比瞎猜高效得多。

卡点 3：图集只需要其中几张，也要全部下载吗？

不必。图文作品的--index参数支持按序号下载指定图片，比如-i "1 3 5"只下第 1、3、5 张，既省流量又省时间。如果作品里还带了动态图片，记得把--live_download打开，不然动图会被漏掉。

四、回到开头：格式自由之后，素材管理才真正开始

还记得阿哲、林姐和老周吗？现在他们的日常变成了这样：阿哲把image_format设为 JPEG，修图单的素材拷过来就能直接开工；林姐在命令行里加一个-if JPEG，客户要什么格式就下什么格式；老周则常年锁定 PNG，透明背景的素材随手可得。三个人解决的问题各不相同，但用的都是同一个功能——下载那一刻就定好格式。

这个功能未来还会更好用。source/module/settings.py 里的配置项一直在扩充，分辨率调整、更多格式适配等能力也在规划中，常去 static/Release_Notes.md 看看更新记录，就不会错过新特性。

想立刻体验，只需克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader

然后按 README 的指引安装依赖、运行 main.py，第一次用建议直接走 TUI 设置界面，30 秒就能把格式配置好。下一次采集小红书素材时，记得先想清楚一个问题：这批图，你想要什么格式？🚀

【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader