Gitee快速开始

> **文档版本**: v1.0.0
> **创建日期**: 2026-02-12
> **最后更新**: 2026-02-12
> **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组
> **状态**: [最新]

> **搜索标签**: Gitee, 码云, 代码托管, Git, 仓库, 克隆
---

# &#127464;&#127475; Gitee（码云）协作快速设置

## 步骤 1: 在 Gitee 创建仓库

1. 访问 https://gitee.com/projects/new
2. 填写仓库信息：
   - 仓库名称：例如 `payroll-saas-system`
   - 是否公开：选择"私有"（如果是商业项目）
   - 初始化仓库：**不勾选**（我们已有代码）
3. 点击"创建"

## 步骤 2: 配置远程仓库

创建仓库后，会显示仓库地址，复制 **HTTPS** 地址：
```
https://gitee.com/<your-username>/<repo-name>.git
```

然后执行：

```bash
# 添加 Gitee 远程仓库
git remote add origin https://gitee.com/<your-username>/<repo-name>.git

# 验证配置
git remote -v
```

## 步骤 3: 推送代码到 Gitee

```bash
# 推送当前分支
git push -u origin refactor/phase-1-cleanup

# 或推送到 main 分支
git checkout main
git push -u origin main
```

## 步骤 4: 邀请同事

### 通过 Gitee 网页端
1. 打开仓库页面
2. 点击 **设置** → **成员管理**
3. 点击 **添加成员**
4. 输入同事的 Gitee 用户名或邮箱
5. 设置权限：
   - **开发者**：可读写代码（推荐）
   - **管理员**：完全控制权限
6. 点击 **确定**

### 通过邀请链接
1. 仓库页面 → **成员管理** → **邀请链接**
2. 复制邀请链接
3. 发送给同事

## 步骤 5: 同事加入项目

同事执行以下命令：

```bash
# 1. 克隆仓库
git clone https://gitee.com/<your-username>/<repo-name>.git
cd <repo-name>

# 2. 安装依赖
pnpm install

# 3. 启动开发环境
pnpm dev
```

## Gitee 特有功能

### 1. 使用 Gitee Pages（可选）
如果需要部署静态网站：
1. 仓库 → **服务** → **Gitee Pages**
2. 选择分支：`main` 或 `develop`
3. 点击 **启动**

### 2. Gitee CI/CD（可选）
如果需要自动化构建：
1. 仓库 → **流水线** → **新建流水线**
2. 选择模板（例如 Node.js）
3. 配置构建命令：
   ```yaml
   install: pnpm install
   build: pnpm run build
   ```

### 3. Gitee 镜像加速（可选）
如果需要访问 GitHub 上的依赖包，可以使用 Gitee 镜像：
```bash
# 使用 Gitee 镜像安装依赖
pnpm config set registry https://registry.npmmirror.com
```

## 常见问题

### Q1: 推送时提示 "Permission denied"
**A**: 检查仓库权限设置，确保已添加为成员并赋予开发者权限。

### Q2: 提示 "repository not found"
**A**: 确认远程仓库 URL 正确：
```bash
git remote -v
```

### Q3: 代码冲突
**A**: 先拉取远程代码再推送：
```bash
git pull origin main --rebase
git push origin main
```

### Q4: 大文件推送失败
**A**: Gitee 默认限制文件大小，可以使用 Git LFS：
```bash
# 安装 Git LFS
git lfs install

# 追踪大文件
git lfs track "*.zip"
git lfs track "*.tar.gz"

# 提交
git add .gitattributes
git commit -m "chore: add git lfs tracking"
```

## 团队协作最佳实践

### 分支命名规范
```bash
feature/your-feature      # 功能开发
fix/bug-name            # Bug 修复
refactor/your-refactor  # 重构
docs/update-docs        # 文档更新
```

### 提交规范
```bash
feat: 添加工资条导出功能
fix: 修复登录页面的布局问题
docs: 更新部署文档
refactor: 优化数据库查询
```

### 工作流程
```bash
# 1. 同步最新代码
git pull origin main

# 2. 创建功能分支
git checkout -b feature/new-feature

# 3. 开发并提交
git add .
git commit -m "feat: 添加新功能"

# 4. 推送到 Gitee
git push origin feature/new-feature

# 5. 在 Gitee 创建 Pull Request
# 仓库 → Pull Requests → 新建 Pull Request
```

## Gitee 官方资源

- **官方网站**: https://gitee.com
- **帮助文档**: https://gitee.com/help
- **API 文档**: https://gitee.com/api
- **客户端下载**: https://gitee.com/gitee/git-installer

## 下一步

1. &#128214; 阅读 [贡献指南](CONTRIBUTING.md)
2. &#128640; 开始邀请同事协作
3. &#127919; 创建第一个 Pull Request

## 获取帮助

- Gitee 帮助文档：https://gitee.com/help
- 项目文档：查看 `docs/` 目录
- 在 Gitee Issues 提问