使用BaiduPCS-Go：命令行网盘工具时遇到的报错解决

🟩报错1

dial tcp [2607:f8b0:400a:806::2011]:443: i/o timeout

报错原因：Go 默认访问 proxy.golang.org，网络超时

✅ 解决方法：设置 GOPROXY 为国内镜像

export GOPROXY=https://goproxy.cn,direct

🟩报错2

build github.com/qjfoidnh/BaiduPCS-Go: cannot load embed: malformed module path "embed": missing dot in first path element

报错原因：Go 版本过低，不支持标准库 embed。

✅ 解决方法：下载最新 Go 安装包

1. 卸载旧版本（如果是 apt 安装的）

sudo apt-get remove golang-go
sudo apt-get remove --auto-remove golang-go

2. 下载最新 Go 安装包
   到 Go 官方下载页面 找到最新版本，比如 go version go1.25.6 linux/amd64

wget https://go.dev/dl/go1.25.6.linux-amd64.tar.gz

3. 解压到 /usr/local

sudo tar -C /usr/local -xzf go1.25.6.linux-amd64.tar.gz

4. 配置环境变量

export PATH=$PATH:/usr/local/go/bin

5. 验证版本

go version

显示

go version go1.25.6 linux/amd64

6.go build后提示

go: updates to go.mod needed; to update it:
        go mod tidy

说明 依赖已经下载了一部分，但 go.mod 文件需要更新。这是 Go Modules 的正常提示。
7.运行 go mod tidy

go mod tidy

8.再次构建

go build

9.登录

./BaiduPCS-Go login

🟩报错3

错误代码: 50052, 消息: 系统繁忙，请稍候再试(50052)

✅ 解决方法：BDUSS 登录（推荐）

1）在浏览器里登录百度网盘。
2）按 F12 打开开发者工具
3）进入 Application（应用）或 Storage（存储）标签页
4）找到 BDUSS=xxxxxx，复制它的值。找到stoken=xxxxxx，复制它的值。

✅ 登录成功

./BaiduPCS-Go login -bduss=HU3VmRjYkRWdVg0YzhjSVpReUp3ZEo1bENKaFh5UlZFNzdvR2hWfkx6TWZ5SjVwSVFBQUFBJCQAAAAAAAAAAAEAAABws5-mbGFpamlhd2VpMTIzNDUAAAAAAAAAAAAAAAAAAAA87d2kfO3dpS -stoken=0173cf4bb74ddac38daffcce7c03aa6d3f452a3ac73fc5

✅ 设置最快参数

./BaiduPCS-Go config set --max_upload_parallel 16 --max_upload_load 4 --max_upload_rate 0

上传文件

./BaiduPCS-Go upload /本地目录 目标目录

下载文件

./BaiduPCS-Go download /path/to/file1 /path/to/file2

⚠️ 注意事项（非常重要）血泪教训！！！

大文件上传前进行压缩

tar -cvf - data | zstd -19 -o data.tar.zst

🟩报错3 传输大文件中断重新开始后遇到进度条来回跳的问题

查看线程

ps aux | grep BaiduPCS-Go

你会发现同时有两个一样的，杀掉所有进程，重新开始吧

pkill -9 BaiduPCS-Go