目录

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 统计
![GitHub Stats](https://github-readme-stats.vercel.app/api?username=1104381746)

③ 查看效果

保存后进入你的个人主页,README 内容会显示在贡献图上方。

5. Profile-README 美化技巧

常用组件

组件代码效果
访问计数![Views](https://komarev.com/ghpvc/?username=你的用户名)统计页面访问量
技术栈徽章![Java](https://img.shields.io/badge/-Java-007396)显示技能标签
统计图![Stats](https://github-readme-stats.vercel.app/api?username=用户名)显示 GitHub 统计
语言分布![Top Langs](https://github-readme-stats.vercel.app/api/top-langs/?username=用户名)编程语言占比图
活动图![Activity Graph](https://github-readme-activity-graph.cyclic.app/graph?username=用户名)最近活动热力线图

布局建议

  • 顶部:简短自我介绍 + 座右铭
  • 中间:技术栈 + 项目展示
  • 底部:联系方式 + 博客链接

💡 可以在 GitHub 搜索 wesome profile readme 或 wesome github profile 看看别人是怎么写的。


小结

  • 理解 Release 的作用,创建了第一个版本发布
  • 理解 Release 的作用,创建了第一个版本发布
  • 知道如何管理已有 Release
  • 创建了 Profile-README 仓库
  • 学会了美化个人主页的基本方法

下一篇:深入仓库最核心的 Code 标签栏,学会浏览代码、查看提交历史、管理分支。


快速自查清单

  • 我理解 Release 是什么
  • 我给仓库创建了一个 Release
  • 我创建了 Profile-README 仓库
  • 我的个人主页有 README 内容了
  • 我知道怎么用 badges 美化主页