GitHub 项目版本管理与 Release 发布教程
本教程适用于希望在 GitHub 上管理代码版本并发布 Release 的开发者。适用于 Git 基础用户，涵盖从代码提交到发布 Release 的完整流程。
1. 配置 Git 环境
1.1 安装 Git
如果尚未安装 Git，可以在 Git 官方网站 下载并安装。
1.2 配置 Git 用户信息
在终端（Windows 用户可以使用 PowerShell 或 CMD）中运行以下命令，设置 Git 用户名和邮箱（GitHub 认证使用）：
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
2. 克隆或初始化 Git 仓库
2.1 克隆远程仓库（已有项目）
如果项目已存在 GitHub 仓库，可使用以下命令克隆：
git clone https://github.com/你的用户名/你的仓库.git
cd 你的仓库
2.2 初始化本地 Git 仓库（新项目）
mkdir 你的仓库
cd 你的仓库
git init
git remote add origin https://github.com/你的用户名/你的仓库.git
3. 代码提交到 GitHub
3.1 打开 VS Code 进行代码编辑
code .
3.2 添加所有更改到暂存区
git add .
3.3 提交更改并写入提交信息
git commit -m "描述本次提交的内容"
注意： 提交信息应简洁清晰，概括本次修改内容。
3.4 推送代码到 GitHub 远程仓库
git push origin main
提示： 可能需要 GitHub 账户身份验证。
4. 创建 Tag 并发布 Release
4.1 创建 Tag 进行版本管理
git tag -a v1.0.0 -m "版本描述"
4.2 推送 Tag 到远程仓库
git push origin v1.0.0
4.3 在 GitHub 上创建 Release
- 打开 GitHub 仓库：你的仓库
- 进入 Releases 页面，点击 Draft a new release。
- 选择 v1.0.0 作为 Tag，并填写 Release 说明。
- 点击 Publish release 发布。
可选方式（命令行发布 Release）：
gh release create v1.0.0 --title "版本 1.0.0" --notes "版本描述"
（需要安装 GitHub CLI，可在 GitHub CLI 官网 下载）
5. 总结
- Git 基础操作：
add（添加文件）、commit（提交）、push（推送）。 - Tag 作用： 记录版本历史，方便回滚和管理。
- GitHub Releases： 便于版本管理和分发源码。
- 身份验证问题： 如果遇到身份验证失败，可使用
git credential reject清除缓存后重新认证。
📌 本教程提供完整 GitHub 版本管理流程，适用于个人开发者及团队协作！ 🚀
