Git 使用指南：本地与远程仓库管理（GitHub）

Git 使用指南：本地与远程仓库管理（GitHub）

1. 仓库初始化与首次推送

git init

初始化本地 Git 仓库

git add .

将所有文件添加到暂存区

git commit -m "initial commit"

提交更改到本地仓库

git remote add origin <你的仓库地址>

关联本地仓库与远程仓库（支持 HTTPS 或 SSH）

git remote set-url origin git@github.com:<用户名/仓库名.git>

将远程地址修改为 SSH 版本（推荐使用 SSH）

git remote -v

查看远程仓库 URL 设置是否正确

git push -u origin main

推送代码到远程仓库并设置默认分支跟踪

2. 配置用户信息（只需配置一次）

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

设置全局 Git 用户名和邮箱

3. 查看仓库状态

git branch

查看本地分支

git remote show origin

查看远程仓库详情

4. 日常更新与推送

每次项目有更新时，进入项目根目录并执行：

git add .
git commit -m "提交信息"
git push

如果只提交部分文件，也可以使用：

git add 文件名

5. 分支命名与管理（master ↔ main）

如果当前分支是 master，希望改为 main：

git branch -m master main

推送新分支并设置默认追踪：

git push origin -u main
git branch -u origin/main

6. 拉取远程更新并处理冲突

git pull origin main

如果出现历史不一致的错误，使用以下方式解决：

方法一：允许合并不相关历史（推荐）

git pull origin main --allow-unrelated-histories
# 如果有冲突，解决后再执行：
git push -u origin main

方法二：强制覆盖远程历史（谨慎使用）

git push -u origin main --force

⚠️ 此命令会清空远程历史，只保留本地提交内容。

补充建议

• 使用 SSH 连接可避免每次输入用户名和密码。
• 推荐使用 main 作为默认分支名称（GitHub 默认也已使用 main）。
• 如用 Android Studio 创建的项目，请确认默认分支是否为 master，如需更改请参考第 5 节内容。