1. 下载 GitHub 资源

GitHub 的核心工具是 git，但根据需求也有其他轻量化选择。

Git (最通用)

这是下载整个版本库（Repository）的标准方式。

• 克隆仓库：（git clone后面的地址可以直接在Github库里复制）

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

• 只克隆最新一次提交（节省空间和时间）

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

Curl / Wget (下载单个文件)

如果你只需要某个脚本或 .zip 压缩包，而不想初始化 Git 仓库：

• 下载主分支压缩包：

  wget https://github.com/用户名/仓库名/archive/refs/heads/main.zip
  

• 下载单个原始文件 (Raw)： 在 GitHub 页面点击文件 -> 点击 "Raw" 按钮获取链接。

  curl -O https://raw.githubusercontent.com/用户名/仓库名/main/file.py
  

---

2. 下载 Hugging Face 资源

Hugging Face 上的资源通常很大（模型权重），建议使用专门的库或工具。

huggingface-cli (官方推荐)

这是目前最快、最稳定的命令行工具，支持断点续传。

• 安装：

  pip install -U "huggingface_hub[cli]"

• 下载整个模型/代码库：

  huggingface-cli download 机构名/模型名
  

• 比如这个的机构名就是google，模型名是gemma-4-31B-it，所以完整指令：huggingface-cli download google/gemma-4-31B-it，也可以直接点复制的标志

• 

• 只下载特定文件：

  huggingface-cli download 机构名/模型名 文件名.bin
  

Git LFS (适用于小模型或代码)

Hugging Face 的仓库本质上也是 Git 仓库，但因为包含大文件，必须先安装 Git LFS (Large File Storage)。

• 安装并初始化

  sudo apt-get install git-lfs
  git lfs install
  

• 克隆仓库：

  git clone https://huggingface.co/机构名/模型名
  

Wget / Curl (下载单个权重文件)

适合快速获取某个特定的 .json 配置文件或权重：

wget https://huggingface.co/机构名/模型名/resolve/main/config.json

---

3. 进阶技巧与加速

针对国内环境的加速 (Mirror)

如果你在国内访问速度较慢，可以使用镜像源：

• GitHub 镜像： 将链接中的 github.com 替换为 github.moeyy.xyz 等代理站。

• Hugging Face 镜像： 设置环境变量使用官方镜像站（如 hf-mirror.com）：

• export HF_ENDPOINT="https://hf-mirror.com"
  huggingface-cli download 机构名/模型名

常用工具对比表

工具	适用场景	优点
Git	GitHub 全库下载	标准化，支持版本管理
huggingface-cli	Hugging Face 权重/代码	强烈推荐，支持断点续传，速度快
Wget / Curl	单个文件/脚本	无需安装额外软件
GH Repo View	浏览 GitHub	配合 gh 官方命令行工具使用

4.Git和pip install的区别

核心区别对比表

特性	Git (git clone)	pip install
目标对象	开发者、贡献者、需要魔改代码的人	普通用户、项目调用者
下载内容	完整的源码、Git 记录 (.git 文件夹)	已编译或打包好的库文件
安装位置	你运行指令的当前目录	Python 的 site-packages (全局或虚拟环境)
依赖处理	不会自动安装代码运行所需的其他库	自动安装该库所依赖的所有其他 Python 包
可更新性	通过 git pull 更新代码	通过 pip install --upgrade 更新

使用场景示例

什么时候用 Git？

• 你想看这个项目的代码是怎么写的。

• 你想修改代码并向作者提交功能（Pull Request）。

• 该项目还没发布到 PyPI 官网上，只能从 GitHub 下载。

• git clone https://github.com/psf/requests.git

什么时候用 pip？

• 你只想在你的程序里用这个库的功能（例如：import requests）。

• 你不在乎源码，只希望它能稳健地运行。

• 你需要自动处理复杂的版本依赖关系。

• pip install requests

5.参数或标志

1. curl -O 是什么意思？

在 curl 命令中，字母的大小写区别很大：

• -O (大写)：代表 Remote Name。它告诉 curl：“下载文件，并直接使用它在服务器上的原始文件名来保存。”

  • 例如：curl -O https://example.com/test.zip 会在本地生成一个名为 test.zip 的文件。

• -o (小写)：代表 Output。它允许你自定义保存的文件名。

  • 例如：curl -o my_new_name.zip https://example.com/test.zip。

2. pip install -U 是什么意思？

在 pip 工具中：

• -U (或 --upgrade)：代表 Upgrade。它告诉 pip：“如果这个包已经安装了，请把它更新到最新的版本。”

  • 如果不加 -U，当你本地已经有一个旧版本时，pip 会提示 Requirement already satisfied 然后什么都不做。

• [cli]：顺带提一下，这个方括号表示额外安装项 (Extras)。有些库有很多可选功能（比如命令行界面、数据库支持等），huggingface_hub[cli] 表示除了安装核心库外，还要安装支持“命令行工具”所需的依赖。

3. 其他常用的指令参数列举

Pip (Python 包管理)

参数	全称	用途
-r	--requirement	从一个文本文件（通常是 requirements.txt）批量安装库。
-i	--index-url	指定下载源（比如使用清华镜像源：-i https://pypi.tuna.tsinghua.edu.cn/simple）。
-e	--editable	可编辑模式。如果你在开发一个库，用这个模式安装后，你修改源码，程序会立即生效，无需重新安装。
--no-cache-dir	-	不使用缓存。当下载出错或空间不足时常用。

Git (版本控制)

参数	用途
-b	Branch。克隆特定的分支，例如 git clone -b dev [URL]。
--depth 1	浅克隆。只下载最后一次提交，不下载漫长的历史记录（下载超大仓库时极快）。
-v	Verbose。显示详细过程，排查网络卡顿时很有用。

Linux 通用工具 (ls, rm, cp 等)

参数	用途
-r / -R	Recursive (递归)。用于文件夹。比如 rm -r（删除文件夹）或 cp -r（复制文件夹）。
-f	Force (强制)。不要问我确不确定，直接执行（危险但高效）。
-h	Human-readable。将文件大小显示为 KB、MB、GB 而不是一长串字节。
-p	Parents。创建目录时如果父目录不存在也一并创建（如 mkdir -p a/b/c）。
-y	Yes。在安装软件时（如 apt install），自动同意所有询问。

4.如果你在终端遇到不认识的字母参数，有两种最快的方法：

1. --help：几乎所有指令都支持这个。输入 pip install --help 或 curl --help，它会列出所有可用字母的含义。

2. man 指令：输入 man curl（Manual），你会进入一个详尽的“说明书”页面（按 q 退出）。