一、核心操作步骤（图文版，新手也能跟）
1. 安装 gh 命令行工具
不同系统安装方式不同，优先用官方推荐方式：
-
Windows ：
打开「命令提示符（CMD）」或「PowerShell」，输入：powershellwinget install GitHub.cli（如果没有 winget，去微软应用商店搜「GitHub CLI」下载，或直接装：https://github.com/cli/cli/releases/latest）
（配置环境和路径）
2. 登录 GitHub 账号（关键步骤）
终端/CMD 输入：
bash
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），输入：
bash
# 创建 v1.0.0 标签 + 新 Release + 上传嵌套文件夹所有文件（保留层级）
gh release create v1.0.0 ./my-nested-folder/** --title "v1.0.0 正式版" --notes "包含多层嵌套文件夹：配置文件/日志/静态资源"场景B：给已存在的 Release 补充上传文件夹
如果已经创建过 v1.0.0 Release，只是想补传嵌套文件夹：
bash
gh release upload v1.0.0 ./my-nested-folder/**二、关键说明
./my-nested-folder/**：**是通配符，代表上传文件夹内所有文件（包括子文件夹里的文件，保留嵌套结构）；- 标签名（如
v1.0.0）：如果仓库里没有这个标签，gh会自动创建； - 上传后验证：打开仓库的
Releases页面，能看到上传的文件夹，点击「Browse files」可直接浏览嵌套层级。
三、官方链接（可直接访问）
gh工具官方安装文档：https://github.com/cli/cli#installationgh release命令官方教程：https://cli.github.com/manual/gh_releasegh release upload详细参数：https://cli.github.com/manual/gh_release_upload
四、常见问题解决
如果上传报错：
- 权限问题：确认登录的账号有仓库的「写入权限」（仓库 → Settings → Collaborators and teams 检查）；
- 路径错误：用
ls（Mac/Linux）或dir（Windows）确认文件夹路径是否正确； - 大文件上传：GitHub Release 单文件最大 2GB，超过的话需用 Git LFS（https://git-lfs.com/）