一、前期准备(必做)
1. 安装 Git
- 下载地址:Git 官网
- 安装后验证:打开终端 / CMD,执行
git --version,显示版本号即成功。
2. 配置 Git 全局用户信息(关联提交记录)
bash
# 配置用户名(建议和 Gitee/GitHub 用户名一致)
git config --global user.name "你的用户名"
# 配置邮箱(建议和 Gitee/GitHub 绑定的邮箱一致)
git config --global user.email "你的邮箱@xxx.com"
# 查看配置是否生效
git config --global --list
3. 配置 SSH 密钥(免密推送,推荐)
HTTPS 方式每次推送需输入账号密码,SSH 方式只需配置一次密钥,更便捷:
bash
# 生成 SSH 密钥(一路回车,默认路径即可,无需设置密码)
ssh-keygen -t ed25519 -C "你的邮箱@xxx.com"
# 查看生成的公钥(复制整段内容)
# Windows:
cat ~/.ssh/id_ed25519.pub
# Mac/Linux:
cat /Users/你的用户名/.ssh/id_ed25519.pub
-
配置到 Gitee:登录 Gitee → 个人设置 → SSH 公钥 → 粘贴公钥 → 保存。
-
配置到 GitHub:登录 GitHub → Settings → SSH and GPG keys → New SSH key → 粘贴公钥 → 保存。
-
验证是否生效:
bash# 验证 Gitee ssh -T git@gitee.com # 验证 GitHub ssh -T git@github.com # 出现 "Hi 你的用户名! You've successfully authenticated..." 即成功
二、本地仓库初始化(从零开始)
假设你的代码在 D:\DevelopmentToolWorkSpace\xx 目录:
bash
# 1. 进入代码目录
cd D:\DevelopmentToolWorkSpace\AndroidStudioProjects\flower-shop
# 2. 初始化本地 Git 仓库(生成 .git 隐藏文件夹)
git init
# 3. 创建 .gitignore 文件(忽略不需要提交的文件,如 Android 的 build、.idea 等)
# 方式1:手动创建(推荐):在项目根目录新建 .gitignore 文件,粘贴 Android 通用忽略规则(文末附模板)
# 方式2:终端快速创建(Windows)
echo .idea/ >> .gitignore
echo build/ >> .gitignore
echo app/build/ >> .gitignore
echo gradle/ >> .gitignore
echo *.iml >> .gitignore
echo local.properties >> .gitignore
# 4. 将所有文件加入暂存区
git add .
# 5. 提交到本地仓库(首次提交,备注清晰)
git commit -m "初始化项目: 基础代码"
三、关联 Gitee 远程仓库并推送
1. 在 Gitee 创建空仓库
- 登录 Gitee → 右上角「+」→ 新建仓库 → 填写仓库名→ 选择「私有 / 公有」→ 「创建」。
- 复制仓库的 SSH 地址。
2. 本地关联 Gitee 远程仓库并推送
bash
# 1. 添加 Gitee 远程仓库(命名为 origin-gitee,便于区分多个远程)
git remote add origin-gitee git@gitee.com:你的用户名/flower-shop.git
# 2. 首次推送(-u 绑定默认推送分支,后续可直接 git push)
# 注意:当前主流分支名是 main(GitHub/Gitee 新版默认),老版本是 master,确认远程分支名
git push -u origin-gitee main
# 若提示 "refusing to merge unrelated histories"(远程有 README/许可证等文件):
git pull origin-gitee main --allow-unrelated-histories
git push -u origin-gitee main
四、关联 GitHub 远程仓库并推送
1. 在 GitHub 创建空仓库
- 登录 GitHub → 右上角「+」→ New repository → 填写仓库名(如 flower-shop)→ 「Create repository」。
- 复制仓库的 SSH 地址(如
git@github.com:你的用户名/flower-shop.git)。
2. 本地关联 GitHub 远程仓库并推送
bash
# 1. 添加 GitHub 远程仓库(命名为 origin-github)
git remote add origin-github git@github.com:你的用户名/flower-shop.git
# 2. 首次推送(绑定默认分支)
git push -u origin-github main
# 若远程有文件冲突,同样先拉取再推送:
git pull origin-github main --allow-unrelated-histories
git push -u origin-github main
五、日常开发 & 同步推送流程
后续修改代码后,只需执行以下步骤即可同步到 Gitee 和 GitHub:
bash
# 1. 查看修改的文件(可选)
git status
# 2. 添加所有修改到暂存区
git add .
# 3. 提交到本地仓库
git commit -m "新增:购物车功能 | 修复:商品列表加载bug"
# 4. 推送到 Gitee
git push origin-gitee main
# 5. 推送到 GitHub
git push origin-github main
六、关键补充说明
1. 查看已关联的远程仓库
bash
git remote -v
# 输出示例:
# origin-gitee git@gitee.com:xxx/flower-shop.git (fetch)
# origin-gitee git@gitee.com:xxx/flower-shop.git (push)
# origin-github git@github.com:xxx/flower-shop.git (fetch)
# origin-github git@github.com:xxx/flower-shop.git (push)
2. 分支相关(可选)
- 创建开发分支:
git checkout -b dev - 切换回主分支:
git checkout main - 合并开发分支到主分支:
git merge dev - 推送分支到远程:
git push origin-gitee dev
3. 常见问题解决
-
推送失败:权限不足:检查 SSH 密钥是否配置正确,或改用 HTTPS 地址(Gitee/GitHub 仓库页面可切换 HTTPS/SSH)。
-
分支名不一致 :若远程默认分支是
master,推送时替换main为master即可。 -
忘记 .gitignore :提交后想忽略文件,需先清除缓存:
bashgit rm -r --cached . git add . git commit -m "更新 .gitignore,忽略无用文件"
总结
核心流程:初始化仓库 → 本地提交 → 关联远程 → 推送,只需一次配置 SSH 和远程仓库,后续只需重复「提交 + 推送」即可同步代码到 Gitee 和 GitHub。