XHS-Downloader完全攻略：小红书无水印作品下载终极指南

2026-02-06 04:18:07作者：姚月梅Lane

🔍 为什么XHS-Downloader是你的必备工具？

XHS-Downloader是一款免费开源的小红书图文/视频作品采集工具，基于AIOHTTP模块开发，让你轻松提取小红书作品链接、下载无水印文件。无论你是内容创作者还是普通用户，这个轻量级工具都能帮你高效保存喜欢的小红书内容。

刚下载好项目，双击运行却弹出黑框一闪而过？命令行显示"Python不是内部命令"？这都是环境配置不当惹的祸！

检查Python版本 → 安装依赖模块 → 启动程序
   ↓                ↓               ↓
  ✅                ✅               ✅

安装Python环境 📌 重点提示：必须安装Python 3.12或更高版本！你可以访问Python官方网站下载安装包，安装时记得勾选"Add Python to PATH"选项。安装完成后，打开终端输入以下命令验证：
```
python --version
```
如果显示类似Python 3.12.0的信息，说明安装成功。
安装依赖模块 打开终端，导航到项目文件夹，输入以下命令：
```
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt
```
📌 重点提示：如果出现"pip不是内部命令"错误，请重新安装Python并确保勾选了PATH选项。
启动程序 在终端中输入以下命令启动程序：
```
python main.py
```
看到程序界面出现，恭喜你成功迈出第一步！

如果反复出现安装问题，建议使用Python官方安装程序，并以管理员身份运行终端。Windows用户可以尝试在命令前加上python -m，如python -m pip install ...。

明明显示下载完成，却找不到保存的图片和视频？文件夹里空空如也，让人抓狂！

了解默认路径 → 自定义保存位置 → 检查权限设置
   ↓                ↓               ↓
  ✅                ✅               ✅

查找默认下载路径 XHS-Downloader的默认下载路径是_internal/Download。这个文件夹位于你的项目根目录下，比如你把项目放在D:\XHS-Downloader，那么文件就保存在D:\XHS-Downloader\_internal\Download。
自定义下载位置 如果你想把文件保存到其他位置，可以通过修改配置文件实现：
1. 打开项目文件夹中的_internal目录
2. 找到并编辑settings.json文件
3. 找到work_path参数，修改为你想要的路径，例如：
```
"work_path": "D:\\小红书下载"
```
📌 重点提示：Windows系统中路径分隔符要用双反斜杠\\，Mac/Linux系统使用单斜杠/。
检查路径权限 如果修改路径后无法保存文件，可能是权限问题：
- 确保你有该文件夹的写入权限
- 路径中不要包含中文或特殊字符
- 尝试使用简单路径如D:\Downloads

建议创建一个专门的文件夹用于保存下载内容，并确保路径中没有空格和特殊字符。可以在桌面创建"小红书下载"文件夹，路径设置为C:\Users\你的用户名\Desktop\小红书下载，这样找文件更方便！

程序能打开，但输入链接后一直转圈？提示"获取数据失败"？90%的可能是Cookie设置问题！

自动获取Cookie → 手动设置Cookie → 验证Cookie有效性
   ↓                ↓               ↓
  ✅                ✅               ✅

自动从浏览器获取Cookie（推荐） 打开终端，输入以下命令（以Chrome浏览器为例）：
```
python main.py --browser_cookie Chrome --update_settings true
```
程序会自动读取浏览器中的小红书Cookie并保存到配置文件。 📌 重点提示：Windows用户可能需要以管理员身份运行终端才能成功读取Cookie。
手动设置Cookie 如果自动获取失败，可以手动获取Cookie：
1. 打开Chrome浏览器，访问小红书网站
2. 按F12打开开发者工具，切换到"网络"选项卡
3. 刷新页面，找到任意以"explore"开头的请求
4. 在请求头中找到"Cookie"字段，复制全部内容
5. 打开_internal/settings.json文件，找到cookie字段，粘贴刚才复制的内容
验证Cookie设置 重启程序，输入一个小红书作品链接，如果能正常显示作品信息，说明Cookie设置成功。

Cookie有时效性，一般有效期为7-15天。如果突然出现获取失败，尝试重新获取并更新Cookie。另外，使用无痕模式获取Cookie可能会更稳定。

想把下载的图片和视频按作者分类？希望文件名包含发布时间？这些高级功能其实很简单！

修改配置文件 → 自定义命名格式 → 启用作者归档
   ↓                ↓               ↓
  ✅                ✅               ✅

自定义文件命名格式 打开_internal/settings.json文件，找到name_format字段，可以使用以下关键词组合：
```
"name_format": "发布时间 作者昵称 作品标题"
```
可用关键词：发布时间、作者昵称、作品标题、作品ID、作品类型等。
按作者分类保存 找到author_archive字段，设置为true：
```
"author_archive": true
```
这样程序会自动为每个作者创建单独的文件夹，方便你整理不同创作者的内容。
设置图片下载格式 找到image_format字段，可以设置为"PNG"、"JPEG"或"WEBP"：
```
"image_format": "PNG"
```
📌 重点提示：部分作品可能不支持所有格式，程序会自动选择可用的最佳格式。