一、Git项目初始化：本地到远程仓库的迁移流程

核心操作步骤

1. 初始化本地仓库
   进入项目根目录，执行以下命令创建本地Git仓库：

   bash
   git init
   

2. 配置用户身份信息
   设置提交代码时的身份标识（建议与GitHub账号信息一致）：

   bash
   git config --global user.name "Your Full Name"
   git config --global user.email "your-github-registered-email@example.com"
   

3. 添加文件并完成首次提交

   bash
   # 添加所有文件到暂存区（建议先创建.gitignore文件过滤无关内容）
   git add .
   # 提交到本地仓库，提交信息需清晰描述内容
   git commit -m "Initial commit: project structure setup"
   

4. 关联远程GitHub仓库
   在GitHub创建新仓库后，将本地仓库与远程仓库关联：

   bash
   git remote add origin https://github.com/your-username/your-repository.git
   

5. 推送代码至远程仓库

   • 若远程仓库为新创建的空仓库：

     bash
     git push -u origin main
     

   • 若远程仓库已存在内容（如README、LICENSE等）：

     bash
     # 先合并远程历史记录
     git pull origin main --allow-unrelated-histories
     # 解决可能的冲突后推送
     git push -u origin main
     

详细说明与注意事项

• .gitignore文件配置
  必须在git add .前创建.gitignore文件，用于排除不需要跟踪的文件（如依赖目录、日志文件、IDE配置文件等）。可从GitHub官方.gitignore模板库获取对应语言或框架的模板，避免将冗余文件提交到仓库。

• 关于强制推送的规范
  强制推送命令git push --force会直接覆盖远程仓库的历史记录，仅适用于以下场景：

  • 个人专属的全新仓库且确认远程内容无价值；
  • 需撤销已推送的错误提交且未影响其他协作者。
    团队协作仓库中严禁使用强制推送，推荐使用更安全的--force-with-lease参数（仅当远程分支未被他人修改时生效）。

• 多账号环境配置
  若需要在同一台设备上管理多个Git账号（如个人账号与工作账号），需移除--global参数，在当前仓库单独配置身份信息：

  bash
  git config user.name "Work Account Name"
  git config user.email "work-email@example.com"
  

二、GitHub身份认证：安全高效的访问方式

核心认证方法

方法1：GitHub CLI工具（gh）

适用于命令行用户，简化认证流程，推荐优先使用：

1. 安装gh工具：参考GitHub CLI官方文档完成跨平台安装（Windows可通过Chocolatey、Mac通过Homebrew、Linux通过apt/yum）；
2. 执行认证命令：

   bash
   gh auth login
   

   按提示选择以下选项：
   • 平台：GitHub.com
   • 认证协议：推荐SSH（无需重复输入凭证）
   • 密钥配置：选择Yes允许工具自动生成并配置SSH密钥
     完成后可通过gh repo list验证认证成功（列出当前账号仓库）。

方法2：个人访问令牌（PAT）

适用于临时操作或单仓库场景，步骤如下：

1. 生成令牌：
   登录GitHub → 点击头像 → Settings → Developer settings → Personal access tokens → Tokens (classic) → 点击"Generate new token"，设置令牌名称、有效期（建议30天内），至少勾选repo权限（仓库读写权限），完成生成后立即保存令牌。
2. 使用方式：
   推送代码时，在用户名栏输入GitHub用户名，密码栏输入生成的PAT。

方法3：SSH密钥认证

适用于频繁操作或多仓库场景，无需重复输入凭证，步骤如下：

1. 生成SSH密钥对：

   bash
   # 使用ed25519算法生成密钥（比RSA更安全）
   ssh-keygen -t ed25519 -C "your-github-email@example.com"
   

   执行后按提示操作（可设置密钥密码增强安全性，或直接按三次回车跳过）。
2. 配置公钥：
   查看公钥内容：cat ~/.ssh/id_ed25519.pub，复制输出的全部内容；
   登录GitHub → Settings → SSH and GPG keys → New SSH key，粘贴公钥并设置名称（如"Workstation SSH Key"）。
3. 验证连接：

   bash
   ssh -T git@github.com
   

   成功提示：Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.

详细说明与注意事项

• GitHub CLI进阶使用
  除认证外，gh工具可直接完成仓库操作，例如：

  • 创建远程仓库：gh repo create your-repository --public
  • 克隆仓库：gh repo clone your-username/your-repository
  • 提交PR：gh pr create
    减少切换浏览器的操作成本，提升开发效率。

• PAT管理规范

  • 令牌权限遵循"最小必要原则"，无需勾选与当前操作无关的权限；
  • 定期轮换令牌（如每月更新），过期或泄露的令牌需立即在GitHub后台吊销；
  • 避免将令牌明文存储在脚本或配置文件中，可使用系统密钥管理工具保存。

• 多账号SSH配置
  若需管理多个GitHub账号，生成密钥时需指定路径：

  bash
  ssh-keygen -t ed25519 -C "work-email@example.com" -f ~/.ssh/id_ed25519_work
  

  并创建~/.ssh/config文件配置密钥映射：

  ssh-config
  # 个人账号
  Host github.com-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519
  
  # 工作账号
  Host github.com-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_work
  

  关联远程仓库时使用对应Host：

  bash
  git remote add origin git@github.com-work:company-account/repository.git
  

• 认证方式兼容性说明
  GitHub自2021年8月起已完全禁用基于账号密码的Git操作认证，若遇到"密码错误"提示，需切换为上述认证方式。

三、分支冲突解决：协作开发中的代码合并策略

核心解决步骤

1. 识别冲突文件
   执行git pull或git merge命令时，若出现"conflict"提示，使用以下命令查看冲突文件：

   bash
   git status
   

   冲突文件会被标记为"both modified"（双方均有修改）。

2. 手动解决冲突
   打开冲突文件，Git会用特殊标记标识冲突区域：

   <<<<<<< HEAD
   // 当前分支（如本地main分支）的修改内容
   const version = "1.0.0";
   =======
   // 待合并分支（如远程main分支）的修改内容
   const version = "1.1.0";
   >>>>>>> origin/main
   

   编辑文件：

   • 保留需要的代码（或整合双方修改）；
   • 必须删除所有冲突标记（<<<<<<<、=======、>>>>>>>）。

3. 完成冲突解决与提交

   bash
   # 标记冲突文件为已解决
   git add <冲突文件名>
   # 提交冲突解决结果，备注需说明解决逻辑
   git commit -m "Resolve merge conflict: update version to 1.1.0"
   # 推送至远程仓库
   git push origin main
   

详细说明与注意事项

• 复杂冲突的工具辅助
  对于多文件或大段代码的冲突，建议使用图形化工具提高效率：

  • VS Code内置工具：打开冲突文件后，界面会显示当前分支、合并结果、待合并分支三个面板，可通过"Accept Current Change"（保留本地）、"Accept Incoming Change"（保留远程）、"Accept Both Changes"（保留两者）按钮快速操作；
  • 专用合并工具：通过git mergetool调用Beyond Compare、KDiff3等工具（需提前配置），支持三向对比与可视化编辑。

• 协作场景的冲突预防

  • 定期同步远程更新：在本地开发前执行git pull origin main，减少与远程仓库的差异；
  • 细分功能分支：避免多人同时修改同一文件的同一部分，建议按功能模块拆分分支（如feature/login、feature/payment）；
  • 及时沟通：遇到跨模块修改时，提前与相关开发者同步，避免重复开发导致的冲突。

• 冲突解决后的验证流程
  解决冲突后必须执行以下步骤验证：

  1. 代码编译检查：确保无语法错误；
  2. 单元测试执行：验证核心功能未受影响；
  3. 业务流程测试：确认冲突修改未破坏关键业务逻辑。

• 冲突处理的回退机制
  若冲突解决过程中出现错误，可通过以下命令中止合并，恢复到操作前状态：

  bash
  git merge --abort
  

总结：核心操作速查表

操作环节	关键命令流程
项目初始化与推送	git init → 配置用户信息 → git add . → git commit → git remote add → （远程非空时先git pull --allow-unrelated-histories） → git push
身份认证	GitHub CLI（gh auth login）、PAT（生成带repo权限的令牌）、SSH（生成密钥+配置公钥）
分支冲突解决	git status识别冲突 → 编辑文件删除冲突标记 → git add → git commit → git push

通过规范执行上述流程，可有效提升代码迁移效率，保障仓库访问安全，减少协作开发中的冲突风险。