以下是 Git 基本使用教程及如何与码云（Gitee）关联的完整步骤，适合初学者快速上手：

---

✅ 一、Git 安装与基础配置

1. 下载安装 Git

• 官网：https://git-scm.com/downloads
• Windows 用户安装时一路点击 Next 即可。

2. 配置用户名和邮箱（与码云一致）

git config --global user.name "你的Gitee用户名"
git config --global user.email "你的Gitee注册邮箱"

---

✅ 二、配置 SSH 公钥（用于免密登录）

1. 生成 SSH 密钥

ssh-keygen -t rsa -C "你的邮箱"

一路回车，默认生成在 ~/.ssh/id_rsa.pub。

2. 查看并复制公钥

cat ~/.ssh/id_rsa.pub

3. 添加到 Gitee

• 登录 Gitee → 右上角头像 → 设置 → SSH公钥 → 粘贴保存

4. 测试连接

ssh -T git@gitee.com

成功提示：Hi xxx! You've successfully authenticated...

---

✅ 三、本地项目与 Gitee 仓库关联

1. 创建远程仓库

• 登录 Gitee → 右上角“+” → 新建仓库 → 填写名称 → 创建

2. 本地初始化项目

cd 项目目录
git init

3. 关联远程仓库

git remote add origin git@gitee.com:你的用户名/你的仓库.git

---

✅ 四、常用 Git 命令

功能	命令示例
克隆仓库	git clone git@gitee.com:xxx/xxx.git
查看状态	git status
添加文件	git add .
提交更改	git commit -m "提交说明"
推送到远程	git push origin master
拉取更新	git pull origin master
查看分支	git branch
创建分支	git branch dev
切换分支	git checkout dev
合并分支	git merge dev

---

✅ 五、首次推送完整流程（本地已有项目）

---

🧩 场景假设

• 本地已有一个项目文件夹 my-project
• 目标：把它变成 Git 仓库并上传到 Gitee 新建的仓库 my-project
• 使用 SSH 协议（免输密码）

---

🚀 步骤 1：安装 / 检查 Git

git --version

没装的去 https://git-scm.com 下载安装，装完重启终端。

---

🚀 步骤 2：全局配置身份（只做一次）

git config --global user.name  "你在Gitee的昵称"
git config --global user.email "你在Gitee的注册邮箱"

---

🚀 步骤 3：生成本地 SSH 公钥（只做一次）

ssh-keygen -t rsa -C "你在Gitee的注册邮箱"
# 一路回车
cat ~/.ssh/id_rsa.pub

复制输出的 整段公钥（以 ssh-rsa 开头）。

---

🚀 步骤 4：把公钥填到 Gitee

1. 登录 https://gitee.com → 右上角头像 → 设置 → SSH 公钥
2. 标题随便填，比如 my-laptop，把刚才复制的公钥粘进去 → 确定
3. 终端测试：

   ssh -T git@gitee.com
   

   看到 Hi 你的昵称! You've successfully authenticated 就 OK。

---

🚀 步骤 5：在 Gitee 新建空仓库

1. 右上角 “+” → 新建仓库
2. 仓库名 my-project，不要勾选 README、.gitignore、License（保持空仓库）
3. 创建后页面会出现两种地址：
   • HTTPS：https://gitee.com/你的用户名/my-project.git
   • SSH：git@gitee.com:你的用户名/my-project.git ← 我们用这个

---

🚀 步骤 6：本地初始化 + 首次上传

进入你的项目目录：

cd /path/to/my-project

依次执行：

# 1. 初始化本地仓库
git init

# 2. 把所有文件加到暂存区
git add .

# 3. 提交（-m 后面写本次提交的说明）
git commit -m "first commit"

# 4. 关联远程仓库（origin 是别名，可改）
git remote add origin git@gitee.com:你的用户名/my-project.git

# 5. 把本地 master 分支推送到远程同名分支，并建立跟踪关系
git push -u origin master

如果远程默认分支叫 main，把最后一条改成：
git push -u origin master:main

---

🚀 步骤 7：验证

浏览器刷新 Gitee 仓库页面，代码已出现，成功！

---

🔄 后续日常更新

以后每次改动只需 3 步：

git add .
git commit -m "feat: 新增xxx功能"
git push

---

🆘 常见报错速查

报错	解决
fatal: remote origin already exists	先 git remote remove origin 再重新 add
src refspec master does not match	远程分支可能是 main，用 git push -u origin master:main
每次 push 让输密码	说明你用了 HTTPS 地址，改成 SSH 地址即可

---

完成！本地项目已完整上传到 Gitee。如需多人协作、分支保护、Pull Request 等高级玩法，继续提问即可。

✅ 六、常见问题提示

• 推送失败？试试强制推送（慎用）：

  git push -f origin master
  

• 提示冲突？先拉取再推送：

  git pull origin master --allow-unrelated-histories
  

---

如需图形界面操作，可使用 Gitee 官方客户端 或 VSCode 自带 Git 工具。

如有更多需求（如多人协作、分支管理、PR 流程），欢迎继续提问！