You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

GitHub开源项目落地页如何设置默认分支或指定Tag

GitHub仓库落地页默认展示指定Tag版本内容的设置方法

你找不到直接设置Tag为默认展示项的入口是正常的——GitHub本身不支持直接将Tag选为仓库默认展示版本,你看到的其他开源项目实现该效果,都是通过「静态分支绑定指定Tag」的方案实现的,具体操作步骤如下:

  • 第一步:基于目标Tag创建独立静态分支
    以你要固定的1.0.2版本为例,在本地仓库执行以下命令,基于该Tag创建一个专门用于对外展示的静态分支(一般命名为stable即可):
    # 拉取远程仓库最新的Tag信息
    git fetch origin --tags
    # 基于1.0.2标签创建stable分支
    git checkout -b stable v1.0.2
    # 将新建的分支推送到远程GitHub仓库
    git push origin stable
    
  • 第二步:修改仓库默认分支配置
    1. 打开你的GitHub仓库页面,点击顶部导航栏的Settings选项
    2. 在左侧通用设置栏向下滑动,找到Default branch配置区
    3. 点击分支切换按钮,下拉选中刚才推送的stable分支,确认保存修改
  • 后续版本更新操作
    如果之后你要把默认展示的版本切换到更高版本的Tag(比如1.0.3),不需要重新改仓库设置,只需要在本地把stable分支的指针指向新Tag,强制推送到远程即可:
    git checkout stable
    git reset --hard v1.0.3
    git push --force origin stable
    

注意:不要往stable分支上合并开发分支的新提交,否则默认展示的内容就会和你绑定的Tag版本不一致,失去版本固定的效果。

内容的提问来源于stack exchange,提问作者Ray Garcia

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.30 06:00:54