小红书作品下载实操指南：用 XHS-Downloader 三步备份原图与高清视频
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
深夜刷到一条绝美的旅行 vlog，想存下来通勤路上慢慢看；翻到一份超详细的穿搭图文，想按原图保存却只能截图——小红书偏偏没有"保存到本地"这个按钮。收藏夹越攒越满，却总觉得内容不属于自己。这种"看得到、带不走"的憋屈，你一定懂。
其实有更好的办法。XHS-Downloader是一款免费开源的小红书链接提取与作品采集工具，能提取账号发布、收藏、点赞、专辑里的作品链接，采集作品信息并解析出原始下载地址，把图片、视频、动图真正存进你的硬盘。三个最打动人的点：免费开源、无需登录即可下载、同时提供界面/命令行/脚本/API 四种玩法，从新手到开发者都能找到顺手的那一种。
一、拿到手：十分钟内跑通第一次下载
别怕，这工具上手门槛低到你怀疑人生。先确认你的电脑有Python 3.12 或更高版本，然后打开终端执行：
git clone https://gitcode.com/gh_mirrors/xh/XHS-Downloader cd XHS-Downloader依赖安装二选一，怕麻烦就选 uv，一条命令搞定：
# 方式一：pip pip install -r requirements.txt # 方式二：uv（推荐） uv sync --no-dev装完依赖，直接启动：
python main.py回车后你会看到一个清爽的图形界面：中间一个输入框，旁边是"下载作品文件""读取剪贴板""清空输入框"三个按钮。把作品链接粘贴进去就能下载——多个链接用空格分隔，程序会自动提取有效链接，explore作品页、xhslink.com短链都认。界面底部的快捷键记一下：Q退出、S设置、R下载记录、M开启剪贴板监听。
源码运行时，下载的文件默认存放在./Volume/Download，配置文件是./Volume/settings.json，第一次运行会自动生成。从克隆仓库到拿到第一个文件，熟练的话真的用不了十分钟。
二、备份整个收藏夹：一条龙实战流程
光会下载单个作品还不够爽，真正让人上瘾的是批量备份。咱们以"把收藏夹完整搬回本地"这个真实任务，把主要功能串一遍。
第一步，用用户脚本把收藏链接全部挖出来。浏览器装上 Tampermonkey 扩展，把项目里的static/XHS-Downloader.js导入为用户脚本，打开小红书页面，右上角就多出一个功能菜单——提取发布、点赞、收藏、专辑作品链接，应有尽有，还能自动滚动页面加载全部内容，收藏再深也逃不掉。
第二步，把链接批量丢给程序。提取出的链接一次性粘贴进界面输入框，点击"下载作品文件"，程序会自动完成"请求数据 → 解析资源 → 下载文件"全流程。想脚本化操作也可以走命令行，几十个参数随便调：
python main.py --url "链接1 链接2 链接3"第三步，享受下载过程的省心细节。收藏夹往往上百个作品，网络一抖就容易中断，别慌——程序内置断点续传，中断后接着下；已经下载过的作品会被记录并自动跳过，不浪费流量；下载记录由source/module/recorder.py持久化到本地数据库，重启程序也不会丢。文件还会按作者、按作品自动归类到独立文件夹，归档整整齐齐。
三、四个小设置，把体验再往上抬一档
基础流程跑通后，下面这四个设置能明显改善体验，在界面里按S或直接编辑settings.json都能改，改完重启生效。配置项由source/module/settings.py统一管理，所有默认值都在那。
| 配置项 | 作用 | 默认值 | 建议 |
|---|---|---|---|
cookie | 小红书网页版 Cookie，无需登录 | 空 | 配置后解锁视频高画质 |
image_format | 图片下载格式：AUTO/PNG/WEBP/JPEG/HEIC | JPEG | 追求原图选 AUTO 或 PNG |
author_archive | 每个作者单独一个文件夹 | false | 批量备份强烈建议开启 |
folder_mode | 每个作品单独一个文件夹 | false | 作品含多图多视频时开启 |
download_record | 记录已下载作品 ID 自动跳过 | true | 保持开启防重复 |
write_mtime | 文件修改时间同步为作品发布时间 | false | 归档强迫症福音 |
proxy | 网络代理 | 无 | 网络受限时填写 |
最值得单独说的是Cookie。它真的不用登录账号，随便在浏览器打开小红书网页版，F12打开开发者工具 → "网络"选项卡 → 刷新页面，在任意xhs/v1开头的请求里找到Cookie字段整段复制即可。配上之后，视频能拿到更高分辨率，请求也更稳。
四、新手最常踩的四个坑
Q1：下载一直失败或者卡住不动？先关掉全局代理试试，很多下载失败都是代理工具干扰导致的。再看程序日志里的具体报错，必要时换一个新的 Cookie 再试。
Q2：下载下来的视频清晰度不高？八成是没配 Cookie。按上文第三节的步骤配上后重启程序，再下载一次，画质立竿见影。
Q3：提示链接失效或被风控？小红书链接自带日期信息，用太久之前抓的链接容易被拦。尽量用最新获取的链接，同时别短时间高频猛拉——程序内置了请求延时机制，保持默认就好。
Q4：怎么升级到新版本？源码运行的用户执行git pull origin main拉取最新代码，再更新一下依赖即可；程序包用户把旧版的 Volume 配置文件夹复制过去，设置无缝迁移。
五、写在最后
从单张原图到整账号批量备份，从图形界面到命令行再到 API/MCP 服务器，XHS-Downloader 把"保存小红书内容"这件小事做到了一个工具能做的极致，还坚持免费、开源、持续维护，社区更新也很活跃，可以放心长期用。
最后也想温柔提醒一句：下载的内容请仅用于个人收藏、灵感积累这类非商业用途，尊重每一位原创作者的劳动成果。工具本身是善意的，怎么使用它，取决于我们每个人。
现在，打开终端跑起你的第一次下载吧——把那些让你心动的瞬间，真正留在自己的硬盘里。
【免费下载链接】XHS-Downloader小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结果作品、用户链接；采集小红书作品信息；提取小红书作品下载地址；下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
