如何在本地把文件上传到GitHub（超过2个G）

一、核心操作步骤（图文版，新手也能跟）

1. 安装 gh 命令行工具

不同系统安装方式不同，优先用官方推荐方式：

• Windows ：
  打开「命令提示符（CMD）」或「PowerShell」，输入：

  winget install GitHub.cli

  （如果没有 winget，去微软应用商店搜「GitHub CLI」下载，或直接装：https://github.com/cli/cli/releases/latest）
  （配置环境和路径）

2. 登录 GitHub 账号（关键步骤）

终端/CMD 输入：

gh auth login

按提示操作：

① 选择账号类型：GitHub.com（回车）；

② 认证方式：选 HTTPS（新手推荐）；

③ 登录方式：选 Login with a web browser（浏览器登录）；

④ 复制终端里的验证码 → 打开浏览器访问 https://github.com/login/device → 粘贴验证码 → 登录你的 GitHub 账号授权。

3. 上传嵌套文件夹到 Release

场景A：创建新 Release 并上传文件夹

假设你要上传的嵌套文件夹路径是 ./my-nested-folder/（比如本地项目里的 dist/ 文件夹），要创建的 Release 标签是 v1.0.0：

终端进入文件夹所在目录（比如 cd /Users/xxx/my-project），输入：

# 创建 v1.0.0 标签 + 新 Release + 上传嵌套文件夹所有文件（保留层级）
gh release create v1.0.0 ./my-nested-folder/** --title "v1.0.0 正式版" --notes "包含多层嵌套文件夹：配置文件/日志/静态资源"

场景B：给已存在的 Release 补充上传文件夹

如果已经创建过 v1.0.0 Release，只是想补传嵌套文件夹：

gh release upload v1.0.0 ./my-nested-folder/**

二、关键说明

• ./my-nested-folder/**：** 是通配符，代表上传文件夹内所有文件（包括子文件夹里的文件，保留嵌套结构）；
• 标签名（如 v1.0.0）：如果仓库里没有这个标签，gh 会自动创建；
• 上传后验证：打开仓库的 Releases 页面，能看到上传的文件夹，点击「Browse files」可直接浏览嵌套层级。

三、官方链接（可直接访问）

1. gh 工具官方安装文档：https://github.com/cli/cli#installation
2. gh release 命令官方教程：https://cli.github.com/manual/gh_release
3. gh release upload 详细参数：https://cli.github.com/manual/gh_release_upload

四、常见问题解决

如果上传报错：

1. 权限问题：确认登录的账号有仓库的「写入权限」（仓库 → Settings → Collaborators and teams 检查）；
2. 路径错误：用 ls（Mac/Linux）或 dir（Windows）确认文件夹路径是否正确；
3. 大文件上传：GitHub Release 单文件最大 2GB，超过的话需用 Git LFS（https://git-lfs.com/）