04 · 发布管理与个人主页
04 · 发布管理与个人主页
这篇的目标:学会用 Release 发布版本、用 Profile-README 美化个人主页。
1. Release 是什么
Release(发布)是给代码仓库打版本标签的功能,通常在项目开发到一定阶段(如 v1.0.0)时使用。每个 Release 包含:
- 版本号标签(如 v1.0.0、v2.3.1)
- 发布说明:描述这个版本的新功能、修复了什么 Bug
- 附件下载:源码压缩包、编译好的二进制文件等
2. 创建 Release
进入仓库页面,点击右侧的 Releases 链接(位于仓库详情区域),或直接访问 /releases 页面。
步骤
① 点击 Create a new release(或 Draft a new release)
② 填写发布信息
| 字段 | 说明 |
|---|---|
| Tag version | 版本标签名,如 v1.0.0 |
| Target | 选择基于哪个分支或 commit |
| Release title | 发布标题,通常和版本号一致 |
| Describe this release | 发布说明,支持 Markdown 格式 |
③ 其他选项
| 选项 | 说明 |
|---|---|
| Set as a pre-release | 标记为预发布版本 |
| Set as the latest release | 设为最新发布(默认自动) |
| Create discussion for this release | 创建关联讨论 |
④ 点击 Publish release 发布
发布后页面
发布后的 Release 页面会显示:
- 版本标题和标签
- 发布日期和发布者
- 发布说明(Markdown 渲染后的内容)
- 源码压缩包下载链接(ZIP / TAR.GZ)
- 评论区(可回复讨论)
- 添加反应(emoji 表情)
2. 管理 Release
在仓库的 /releases 页面可以:
- 查看所有已发布的版本列表
- 编辑已有 Release
- 删除 Release
- 将 Release 置顶
💡 建议遵循语义化版本规范:主版本.次版本.修订号(如 v2.1.3)。
3. Profile-README 是什么
Profile-README 是一个特殊的仓库 README。当你创建一个和你的用户名同名的仓库(如 RainbowLand/RainbowLand),并在其中添加 README.md 文件,该文件的内容会自动显示在你的 GitHub 个人主页顶部。
效果
进入个人主页(头像 → Profile),在贡献图上方会显示 Profile-README 的内容。这是展示个人介绍、技能、项目链接的好方式。
4. 创建 Profile-README
步骤
① 创建同名仓库
点击 ➕ → New repository,仓库名输入你的用户名(如 RainbowLand)。GitHub 会提示你:You found a secret! RainbowLand/RainbowLand is a ✨special ✨ repository. 勾选 Add a README file 并创建。
② 编辑 README.md
创建后进入仓库,编辑 README.md 文件,可以用 Markdown 格式写你的个人介绍:
# 你好,我是 RainbowLand 👋
## 🚀 关于我
- 后端开发工程师
- 正在学习 GitHub 和开源
- 热爱技术与分享
## 🔧 技术栈
- 语言:Java, Python, JavaScript
- 框架:Spring Boot, Vue
- 工具:Git, Docker, Linux
## 📈 GitHub 统计
③ 查看效果
保存后进入你的个人主页,README 内容会显示在贡献图上方。
5. Profile-README 美化技巧
常用组件
| 组件 | 代码 | 效果 |
|---|---|---|
| 访问计数 |  | 统计页面访问量 |
| 技术栈徽章 |  | 显示技能标签 |
| 统计图 |  | 显示 GitHub 统计 |
| 语言分布 |  | 编程语言占比图 |
| 活动图 |  | 最近活动热力线图 |
布局建议
- 顶部:简短自我介绍 + 座右铭
- 中间:技术栈 + 项目展示
- 底部:联系方式 + 博客链接
💡 可以在 GitHub 搜索 wesome profile readme 或 wesome github profile 看看别人是怎么写的。
小结
- 理解 Release 的作用,创建了第一个版本发布
- 理解 Release 的作用,创建了第一个版本发布
- 知道如何管理已有 Release
- 创建了 Profile-README 仓库
- 学会了美化个人主页的基本方法
下一篇:深入仓库最核心的 Code 标签栏,学会浏览代码、查看提交历史、管理分支。
快速自查清单
- 我理解 Release 是什么
- 我给仓库创建了一个 Release
- 我创建了 Profile-README 仓库
- 我的个人主页有 README 内容了
- 我知道怎么用 badges 美化主页