Linux如何创建主干分支？

在Linux环境下使用Git进行版本控制时，主干分支（通常为main或master分支）是项目的核心开发线，承载着稳定、可发布的代码，创建和管理主干分支是团队协作的基础，本文将详细介绍在Linux系统中通过Git命令行创建主干分支的具体步骤、注意事项及最佳实践。

准备工作：安装与配置Git

在创建分支前，需确保Linux系统已安装Git，并完成基本配置，打开终端，执行以下命令检查Git是否安装：

git --version

若未安装，可通过包管理工具安装（以Ubuntu/Debian为例）：

sudo apt update
sudo apt install git

安装后，配置用户信息（必填，用于提交记录标识）：

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

创建主干分支的两种场景

根据项目是否已初始化Git仓库，创建主干分支分为两种场景：全新仓库创建主干分支和已有仓库迁移主干分支。

（一）场景1：全新仓库创建主干分支

对于新项目，可直接初始化Git仓库并创建主干分支。

1. 初始化仓库
   进入项目目录，执行git init初始化本地仓库：

   cd /path/to/your/project
   git init

   执行后，当前目录会生成.git隐藏文件夹，表示Git仓库初始化成功，默认情况下，Git会创建名为master的分支（早期版本默认），但现代Git推荐使用main作为主干分支名称（更具包容性）。

2. 创建并切换到主干分支
   使用git checkout -b命令创建新分支并立即切换：

   git checkout -b main

   命令解释：-b表示创建新分支，main为分支名，执行后，可通过git branch查看当前分支：

   

   git branch

   输出结果中，带的分支为当前分支，

   * main
     master

3. 设置默认分支（可选）
   若希望未来新仓库的默认分支为main，可执行：

   git config --global init.defaultBranch main

   此后，通过git init初始化的新仓库将直接创建main分支，无需手动切换。

（二）场景2：已有仓库迁移主干分支

若项目已存在Git仓库（如默认为master分支），需将主干分支从master迁移至main，或基于现有分支创建新的主干分支。

1. 查看当前分支状态
   执行git branch -a查看所有本地及远程分支：

   git branch -a

   输出示例（假设已有master分支及远程origin/master）：

   * master
     remotes/origin/master

2. 基于现有分支创建主干分支
   若需从master分支创建新的main分支，并保留master的提交历史：

   git checkout -b main master

   此命令会基于master分支创建main分支，并切换到main分支。

3. 重命名默认分支（若需废弃master）
   若希望彻底将master重命名为main（需确保所有开发者同步操作）：

   

   • 本地分支重命名：

     git branch -m master main  # -m表示移动/重命名

   • 更新远程分支引用：
     若远程仓库存在master分支，需推送新分支并删除旧分支：

     git push -u origin main    # 推送main分支并设置上游
     git push origin --delete master  # 删除远程master分支

   • 强制更新本地分支跟踪：
     若其他开发者已克隆仓库，需执行以下命令同步分支变更：

     git fetch origin
     git branch -u origin/main  # 设置本地main分支跟踪远程main

主干分支的管理与维护

创建主干分支后，需通过规范操作确保其稳定性，主要包括分支保护、提交规范及远程同步。

（一）分支保护（团队协作场景）

在团队开发中，主干分支应避免直接提交，需通过合并请求（Merge Request）或拉取请求（Pull Request）进行代码审核，可通过Git钩子（如pre-receive钩子）或Git托管平台（如GitHub、GitLab）的分支保护功能实现：

• GitHub操作：仓库Settings → Branches → Add branch protection rule，设置分支名称（如main），勾选“Require pull request reviews before merging”和“Require status checks to pass before merging”。
• 本地钩子：在.git/hooks目录下创建pre-receive脚本,禁止直接推送非审核通过的代码到主干分支。

（二）提交规范与同步

1. 常规提交操作
   在主干分支上，仅合并经过测试的稳定代码，开发时应在功能分支（如feature/login）上开发，完成后通过以下流程合并到主干：

   git checkout main          # 切换到主干分支
   git pull origin main      # 拉取最新远程代码
   git merge feature/login   # 合并功能分支
   git push origin main      # 推送到远程

2. 解决冲突
   若合并时出现冲突（如多人修改同一文件），需手动编辑冲突文件，标记冲突已解决后提交：

   git add <冲突文件>         # 标记冲突已解决
   git commit -m "Resolve merge conflict in <文件名>"

常用Git分支命令参考

以下表格总结了创建和管理主干分支的常用命令及说明：

注意事项

1. 分支命名规范：主干分支建议统一使用main（避免与默认的master混淆），功能分支可使用feature/、bugfix/等前缀（如feature/user-auth）。
2. 远程仓库同步：确保主干分支与远程仓库保持同步，避免因本地分支落后远程导致合并失败。
3. 避免直接修改主干：直接在主干分支上修改代码可能导致不稳定，应通过功能分支开发并审核后合并。

相关问答FAQs

Q1: 如何将现有仓库的master分支重命名为main，并确保团队成员同步？
A: 重命名分支需分本地和远程操作：

1. 本地操作：在仓库根目录执行git branch -m master main，将本地master重命名为main。
2. 远程操作：推送新分支并删除旧分支：git push -u origin main，然后git push origin --delete master。
3. 团队同步：通知所有开发者执行以下命令：

   git fetch origin          # 拉取远程最新信息
   git branch -m master main  # 重命名本地分支
   git branch -u origin/main  # 设置跟踪关系
   git remote prune origin    # 清理远程分支引用（可选）

Q2: 创建主干分支后，如何设置每次提交自动附加分支信息？
A: 可通过Git的commit.template配置，在提交时自动包含分支信息，步骤如下：

1. 创建模板文件（如~/.gitcommit_template包含分支占位符：

   echo "Branch: $(git rev-parse --abbrev-ref HEAD)" > ~/.gitcommit_template

2. 配置Git使用模板：

   git config --global commit.template ~/.gitcommit_template

3. 后续提交时，执行git commit会自动打开编辑器，显示当前分支信息,只需补充提交内容即可。