GDriveDL：极速掌握谷歌云盘文件下载工具

一、功能解析：核心模块一目了然

1.1 文件解析器——链接转ID的幕后英雄

💡 功能类比：就像快递柜取件码提取器，从复杂的谷歌云盘链接中提取"文件身份证"（FILE_ID）

核心能力：

• 自动识别4种链接格式（文件/文件夹/共享链接/直接ID）
• 支持正则表达式智能匹配，成功率超99%

1.2 下载引擎——断点续传的得力助手

⚠️ 技术亮点：内置Cookie管理系统，像浏览器一样记住下载状态，支持大文件分片下载（默认64KB/块）

二、环境准备：5分钟极速部署

2.1 安装Python环境

▶️ 目标：搭建运行基础
▶️ 操作：python --version
▶️ 预期：显示Python 3.6+版本号（如无请先安装Python）

💡 新手提示：Python是一种编程语言，就像英语是国际通用语言，让电脑能理解你的指令

2.2 获取项目代码

▶️ 目标：下载程序文件
▶️ 操作：git clone https://gitcode.com/gh_mirrors/gd/gdrivedl
▶️ 预期：创建gdrivedl文件夹，内含核心程序

2.3 安装依赖包

▶️ 目标：配备辅助工具
▶️ 操作：cd gdrivedl && pip install -r requirements.txt
▶️ 预期：显示"Successfully installed"提示

⚠️ 重要警告：依赖包（项目运行所需的辅助工具集合）必须全部安装，否则程序无法启动

三、实战操作：三步完成文件下载

3.1 基础下载流程

1️⃣ 获取共享链接：在谷歌云盘右键文件→"获取链接"
2️⃣ 执行下载命令：▶️ python gdrivedl.py "共享链接"
3️⃣ 查看结果：文件自动保存到当前文件夹

3.2 指定保存位置

▶️ 目标：自定义下载路径
▶️ 操作：python gdrivedl.py -P /home/download "共享链接"
▶️ 预期：文件保存到/home/download目录

💡 小技巧：使用-O参数可直接重命名文件，如-O myfile.zip

3.3 三行命令排查常见错误

▶️ 检查链接有效性：echo "共享链接" | grep "drive.google.com"
▶️ 查看网络状态：ping drive.google.com -c 1
▶️ 重置下载缓存：rm -rf ~/.cache/gdrivedl

四、进阶技巧：效率提升指南

4.1 批量下载秘籍

创建urls.txt文件，每行一个链接，执行：
▶️ python gdrivedl.py -f urls.txt

4.2 自定义参数速查表

参数	功能描述	适用场景
-q	安静模式，无进度显示	后台运行时
-m	保留修改时间	同步备份时
-d	调试模式，显示详细日志	解决下载问题时
-e	错误继续，跳过失败项	批量下载大量文件时

4.3 文件夹下载全攻略

1️⃣ 获取文件夹共享链接（需开启"任何有链接的人可查看"权限）
2️⃣ 执行命令：▶️ python gdrivedl.py "文件夹链接"
3️⃣ 等待完成：程序会自动创建文件夹结构并下载所有文件

💡 效率提示：大型文件夹建议分多次下载，配合-m参数可避免重复下载已更新文件