企业官网建设流程全解析

三步突破百度网盘转存上限：BaiduPCS-Go 批量转存实操完整指南

【免费下载链接】BaiduPCS-Goiikira/BaiduPCS-Go原版基础上集成了分享链接/秒传链接转存功能项目地址: https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go

BaiduPCS-Go 是百度网盘的命令行客户端，支持分享链接转存与转存后自动下载。当批量转存被提示"转存文件数超过当前用户上限"时，如何拆任务、绕开单次上限并把文件完整落盘，下面的步骤从预览到排错一次讲清。

问题与来源：批量转存为什么会被拦

一次转存几百个文件的分享时，程序常直接失败，报错"转存文件数xxx超过当前用户上限"。原因并不神秘：百度对每个账号设置了单次转存文件数的上限，账号等级不同，这个额度也不同——普通号额度小，SVIP 额度宽裕。转存请求把文件总数报上去，一旦超过你的额度，服务端就整体拒绝，不分批、不部分成功。程序会同时打印出你的实际上限值（报错里带"当前用户单次最大转存数x"字样，具体判断逻辑可对照 baidupcs/transfer.go 查证），这个数字就是后面拆分任务时的依据。

⚙️ 三步破限方案

知道上限只是起点，真正让批量转存跑起来要靠下面三步，按顺序做即可。

第一步：核对账号与登录状态

转存依赖 STOKEN（百度登录凭证之一，没有它连分享页都打不开）。先用账号登录并确保带了 STOKEN：

BaiduPCS-Go login -bduss=<你的BDUSS> -stoken=<你的STOKEN>

登录成功后程序会提示账号名；如果后续转存仍提示"请确认登录参数中已经包含了网盘STOKEN"，就是这一步没做对。

第二步：调两个参数提升转存吞吐

转存完成后的下载环节受两个并发参数控制，推荐值如下：

• max_parallel：总并发量。非 SVIP 建议保持 1，SVIP 可逐步上调到 10~20；
• max_download_load：同时下载的文件数，建议 2~3。

一条命令写入：

BaiduPCS-Go config set -max_parallel 1 -max_download_load 2

配置文件在 Windows 位于%APPDATA%\BaiduPCS-Go，其他系统位于$HOME/.config/BaiduPCS-Go；也可以用环境变量BAIDUPCS_GO_CONFIG_DIR把配置指到任意目录（细节见 internal/pcsconfig/）。

第三步：三种拆分转存任务的方式

把总量拆到单次上限以内，有三种做法，任选其一：

通配符筛选 + fs_id 精确转存：transfer 本身没有通配符参数，思路是先用ls的通配符筛出目标清单（比如只要 .pdf），记下对应文件的 fs_id，再用--fs_id只转存这部分：

BaiduPCS-Go transfer <分享链接> <提取码> --fs_id 123456

--fs_id官方说明就是"用于绕过大文件夹数量限制"，逐批换 fs_id 即可把一个大分享切成多个小任务。

按目录层级拆分：把大分享拆成几个子目录分别转存，每个子目录单独走一次 transfer：

BaiduPCS-Go cd /我的资源/第一批 && BaiduPCS-Go transfer <分享链接> <提取码>

换到/我的资源/第二批再执行同样的命令，批次之间互不影响，失败也只重跑一批。

多账号轮换：多个账号依次承接同一分享的剩余部分，先列出账号再切换：

BaiduPCS-Go loglist && BaiduPCS-Go su <uid或账号名>

🔗 从预览到自动下载：一条完整的批量转存链路

拆好任务后，按下面的命令链从预览一路执行到落盘：

BaiduPCS-Go ls /我的资源

用 ls 预览目标目录（支持/我的*这类通配符），确认落点结构、排查同名文件。

BaiduPCS-Go cd /我的资源

转存固定存入当前目录，先 cd 进目标位置。

BaiduPCS-Go transfer https://pan.baidu.com/s/1AbCdEf 1234

执行转存；提取码也可挂在链接后（?pwd=1234）。

BaiduPCS-Go transfer https://pan.baidu.com/s/1AbCdEf 1234 --download

加--download后转存成功即自动开始下载，免去二次操作。

BaiduPCS-Go download "我的资源/文件夹名" --saveto /data/save

不想用默认目录时，用 download 的--saveto单独指定落盘路径。

🩺 出问题怎么办：常见报错速查表

链路跑不通时，先对照下表定位，多数情况一条命令就能解决：

📌 让转存更顺手的五个小习惯

• 转存前先用ls预览目录，发现同名文件提前处理，避免"当前目录下已有同名文件/文件夹"。
• 每批转存量控制在账号上限内，不同批次存入不同子目录，失败时只重跑一批。
• 定期清理网盘里已失效的大文件，空间不足是转存失败最隐蔽的原因之一。
• 定期备份配置目录下的pcs_config.json，换机或重装后登录状态不必从头再来。
• 保持程序更新，百度接口有变动时新版本兼容性更好，参考 docs/README.md 了解升级方式。

更多参数含义与边界情况，可查官方文档 docs/README.md 的"已知问题"章节；配置项的完整清单见 internal/pcsconfig/ 源码目录，报错文案与转存判断逻辑在 baidupcs/transfer.go 中可直接核对。

【免费下载链接】BaiduPCS-Goiikira/BaiduPCS-Go原版基础上集成了分享链接/秒传链接转存功能项目地址: https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go