2025年最新！如何用XHS-Downloader轻松下载小红书视频和图片？完整指南

XHS-Downloader是一款免费开源的小红书图文/视频作品采集工具，基于AIOHTTP模块开发，轻量高效且完全免费。无论是想保存心仪的穿搭教程、美食攻略还是旅行Vlog，它都能帮你一键搞定！本文将带你从安装到高级使用，彻底玩转这款神器！🚀

为什么选择XHS-Downloader？三大核心优势

✅ 完全免费+开源透明

作为开源项目，XHS-Downloader的源代码完全公开（核心模块位于source/application/），无广告无捆绑，让你用得安心。

✅ 支持全平台运行

无论是Windows、Mac还是Linux系统，都能轻松部署。提供两种操作界面：

• 命令行模式：适合技术党快速操作（源码位于source/CLI/）
• 图形界面（TUI）：新手友好的交互设计（界面代码在source/TUI/）

✅ 功能强大到离谱

• 📸 自动识别并下载图文笔记中的所有图片
• 🎥 高清保存视频内容，可选是否保留水印
• 📝 自动记录下载历史（通过source/module/recorder.py实现）
• ⚡ 多任务并行下载，速度提升300%

超简单！三步安装XHS-Downloader

1️⃣ 获取源码

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

2️⃣ 安装依赖

pip install -r requirements.txt

3️⃣ 启动程序

根据你的偏好选择启动方式：

# 命令行模式
python main.py --cli

# 图形界面模式
python main.py

首次启动会自动生成配置文件，保存在程序根目录下。

手把手教程：用XHS-Downloader下载第一个作品

准备工作：获取小红书Cookie

1. 打开浏览器访问小红书网页版
2. 按F12打开开发者工具 → 切换到"网络"选项卡
3. 刷新页面，找到任意以xhs/v1开头的请求
4. 复制请求头中的Cookie值

图：Cookie获取位置示意图，包含XHS-Downloader核心关键词

开始下载：两种方法任你选

方法1️⃣ 命令行模式（适合批量操作）

# 下载单个作品
python main.py --url https://www.xiaohongshu.com/item/xxx

# 批量下载（从文件导入URL列表）
python main.py --file urls.txt

方法2️⃣ 图形界面模式（适合新手）

1. 启动程序后点击"设置"按钮
2. 粘贴Cookie并保存
3. 返回主界面输入作品链接
4. 点击"开始下载"，进度实时可见

图：XHS-Downloader主界面展示，包含下载进度和历史记录面板

高级玩法：这些隐藏功能90%的人不知道

🎯 自定义下载路径

修改配置文件中的download_path参数，默认路径为程序根目录下的downloads文件夹。配置管理由source/module/settings.py模块处理。

🚀 使用代理加速下载

如果遇到访问问题，可在设置中配置代理：

[NETWORK]
proxy = http://127.0.0.1:7890
timeout = 30

📱 配合浏览器插件使用

项目提供浏览器扩展功能（源码在source/expansion/browser.py），安装后可一键发送链接到下载器，实现"看到即下载"！

图：浏览器插件一键发送下载链接演示，含XHS-Downloader操作界面

常见问题Q&A

❓ 下载失败怎么办？

1. 检查Cookie是否过期（建议每月更新一次）
2. 确认网络连接正常，可尝试切换代理
3. 查看日志文件（位于logs/目录）排查错误

❓ 如何更新程序到最新版本？

git pull origin main
pip install -r requirements.txt --upgrade

写在最后：开源项目需要你的支持

XHS-Downloader作为免费工具，离不开开发者的持续维护和社区贡献。如果你觉得好用，可以：

• 给项目点个Star ⭐
• 提交代码改进（特别是source/expansion/模块欢迎扩展）
• 在issues中反馈bug或建议

现在就打开你的小红书，试试用XHS-Downloader下载收藏已久的作品吧！有任何问题，欢迎查阅项目文档或在社区讨论区交流。祝大家使用愉快！🎉

提示：请遵守平台规则，下载内容仅用于个人学习，勿作商业用途