如何用命令下载GitHub文件？

准备工作

1. 安装必要工具：

   • Git：用于克隆仓库（官网下载）
   • cURL 或 wget：用于下载单个文件（Windows用户需安装Git Bash或WSL）

2. 获取文件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/用户名/仓库名/分支名/文件路径

参数说明：

• -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 分支名

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

常见问题解决

1. 原始链接404错误：

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

2. 大文件下载失败：

   

   • 使用Git LFS（需安装）： git lfs install git clone https://github.com/用户名/仓库名.git

   • 权限问题：

     • 私有仓库需添加SSH密钥或使用GitHub Token。

     方法对比建议

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

     ---

     命令行下载GitHub文件的核心在于：

     1. 完整项目 → 用 git clone
     2. 单个文件 → 用 curl 或 wget + Raw链接
     3. 特定文件夹 → 用 sparse-checkout

     掌握这些方法可显著提升开发效率，尤其适合自动化脚本和服务器环境操作,建议优先使用官方Git工具以保证兼容性。

     引用说明：本文方法参考GitHub官方文档《Cloning a Repository》及开发者社区实践，命令行工具用法遵循cURL官方指南与Git手册。