# gitee

**Repository Path**: songtz/gitee

## Basic Information

- **Project Name**: gitee
- **Description**: gitee教程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-30
- **Last Updated**: 2025-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Ubuntu系统下Gitee使用教程：

---

### **1. 安装Git**
如果尚未安装Git，先执行：
```bash
sudo apt-get update
sudo apt-get install git
```

### **2. 配置Git全局信息**
设置用户名和邮箱（与Gitee账户一致）：
```bash
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"
```

### **3. 生成SSH密钥并添加到Gitee**
- 生成密钥（按回车跳过密码设置）：
  ```bash
  ssh-keygen -t rsa
  ```
- 查看公钥并复制：
  ```bash
  cat ~/.ssh/id_rsa.pub
  ```
- 将公钥添加到Gitee：  
  登录Gitee → 右上角头像 → `设置` → `SSH公钥` → 粘贴密钥并保存。

### **4. 验证SSH连接**
```bash
ssh -T git@gitee.com
```
看到 `You've successfully authenticated` 即表示成功。

---

### **5. 初始化本地仓库**
进入项目目录并初始化：
```bash
cd /path/to/your/project
git init
```

### **6. 添加文件到暂存区**
```bash
git add .  # 添加所有文件
git add filename  # 或指定文件 
```

### **7. 提交到本地仓库**
```bash
git commit -m "首次提交"
```

---

### **8. 关联Gitee远程仓库**
- **情况1：Gitee已有空仓库**  
  复制仓库SSH地址（如 `git@gitee.com:yourname/repo.git`），然后执行：
  ```bash
  git remote add origin git@gitee.com:yourname/repo.git
  ```

- **情况2：本地项目首次推送到Gitee**  
  先在Gitee网页端创建新仓库（不要初始化README），然后按上述命令关联。

### **9. 推送到远程仓库**
```bash
git push -u origin master  # 首次推送需加 -u
```
后续推送直接使用：
```bash
git push origin master
```

---

### **常见问题处理**
- **推送冲突**：先拉取远程更改 `git pull --rebase origin master`，解决冲突后再推送。
- **分支名称差异**：若Gitee默认分支为 `main`，将命令中的 `master` 替换为 `main`。
- **权限错误**：检查SSH密钥是否绑定正确，或改用HTTPS地址（需输入账号密码）。

---

完成以上步骤后，本地代码即同步到Gitee仓库。可通过 `git log` 或Gitee网页查看提交记录。

---

### **10. 常用命令**
```bash
git remote -v  # 查看远程仓关联信息
git status  # 查看本地仓修改记录
git diff  # 查看所有文件的详细改动（按q退出）
git diff 文件名  # 查看单个文件的改动
```