当前位置：首页 > 电脑教程 > 正文

如何用命令下载GitHub文件？

admin
电脑教程
2025-06-10
4689

使用 curl或 wget命令可直接下载GitHub单个文件，下载整个项目或文件夹需使用 git clone命令复制仓库到本地。

准备工作

安装必要工具：
- Git：用于克隆仓库（官网下载）
- cURL 或 wget：用于下载单个文件（Windows用户需安装Git Bash或WSL）
获取文件URL：
- 在GitHub页面点击目标文件 → 选择 “Raw” → 复制浏览器地址栏链接（原始文件直链）。

命令行下载方法

方法1：下载整个仓库（Git Clone）

git clone https://github.com/用户名/仓库名.git

适用场景：需下载整个项目（含所有文件和历史记录）。
示例：

git clone https://github.com/octocat/Spoon-Knife.git

方法2：下载单个文件（cURL）

curl -O https://raw.githubusercontent.com/用户名/仓库名/分支名/文件路径

参数说明：

如何用命令下载GitHub文件？第1张

-O：以远程文件名保存到当前目录。
示例（下载README.md）：
```
curl -O https://raw.githubusercontent.com/octocat/Spoon-Knife/main/README.md
```

方法3：下载单个文件（wget）

wget https://raw.githubusercontent.com/用户名/仓库名/分支名/文件路径

示例：

wget https://raw.githubusercontent.com/octocat/Spoon-Knife/main/README.md

方法4：下载特定文件夹（Sparse Checkout）

git init
git remote add -f origin https://github.com/用户名/仓库名.git
git config core.sparseCheckout true
echo "文件夹路径/*" >> .git/info/sparse-checkout
git pull origin 分支名

适用场景：仅需下载仓库中的某个子目录。

常见问题解决

原始链接404错误：
- 检查URL是否包含/raw/或?raw=true（旧版链接格式）。
- 确保分支名正确（如main而非master）。

大文件下载失败：

使用Git LFS（需安装）：

git lfs install
git clone https://github.com/用户名/仓库名.git

权限问题：
- 私有仓库需添加SSH密钥或使用GitHub Token。

方法对比建议

方法	适用场景	优势
`git clone`	下载完整项目	保留版本历史，可更新
`curl`/`wget`	快速下载单个文件	无需安装Git
Sparse Checkout	下载特定文件夹	节省磁盘空间