github使用手册

将 GitHub 仓库里的文件下载到本地有两种常用方式，一种是克隆整个仓库（方便后续同步更新），另一种是单独下载指定文件/仓库压缩包（适合仅需一次性获取文件），以下是详细步骤：

方式一：克隆整个仓库（推荐，Git 命令行）

这种方式会把仓库完整下载到本地，且保留 Git 版本记录，后续可通过 git pull 同步远程更新。

前提：

本地已安装 Git（下载地址：https://git-scm.com/downloads，安装时一路默认即可）。

操作步骤：

1. 打开终端/命令提示符（Windows 按 Win+R 输入 cmd，Mac/Linux 打开 Terminal）。
2. 切换到想存放仓库的目录（比如想放到桌面的 github_files 文件夹）：

   # Windows 示例（切换到桌面）
   cd Desktop
   # 新建文件夹（可选）
   mkdir github_files
   cd github_files
   

3. 执行克隆命令（粘贴仓库地址）：

   git clone https://github.com/2160912122/zhilianbiji.git
   

4. 等待执行完成，本地会生成 zhilianbiji 文件夹，里面就是仓库所有文件。

方式二：直接下载（无需安装 Git）

1. 下载整个仓库的压缩包

• 打开仓库网页：https://github.com/你的用户名/你的仓库名.git
• 点击页面右上角的绿色按钮 <> Code，在弹出的菜单中选择 Download ZIP：
  ![下载ZIP]
• 下载完成后解压 ZIP 文件，即可得到仓库所有文件。

2. 下载单个/指定文件

• 打开仓库网页，找到需要下载的文件（比如 README.md），点击进入文件详情页。
• 点击文件右上角的 Raw 按钮，进入文件的原始内容页面：
  ![Raw按钮]
• 在原始页面中，按 Ctrl+S（Windows）/ Cmd+S（Mac）保存文件到本地，注意保留文件后缀（比如 .md/.py）。

常见问题解决

如果克隆时提示「认证失败」：

• GitHub 已停用密码认证，需改用「个人访问令牌（PAT）」：
  1. 登录 GitHub，进入「Settings → Developer settings → Personal access tokens」；
  2. 生成令牌（勾选 repo 权限），复制令牌；
  3. 克隆时，用户名填 GitHub 账号，密码填这个令牌即可。

如果只是临时获取文件，选「方式二」更快捷；如果需要后续修改、同步仓库，选「方式一」更方便。