一、环境准备与前置条件

1.1 开发环境配置

在开始操作前需确保：

已安装Git客户端（版本建议≥2.30.0）
具备基础命令行操作能力
网络可正常访问代码托管平台

1.2 平台账号注册

访问主流代码托管平台官网，通过手机号/邮箱完成账号注册。建议开启双重验证提升账户安全性，注册后需在账户设置中完善个人信息，特别是SSH公钥配置（后续章节详述）。

二、远程仓库创建与管理

2.1 仓库初始化流程

控制台操作：登录后进入用户中心，点击「新建仓库」按钮
基础信息配置：
- 仓库命名规范：建议采用项目名-模块格式（如ai-platform-core）
- 可见性选择：
  - 公开仓库：适合开源项目，需遵守平台开源协议
  - 私有仓库：企业级项目推荐，可设置成员权限
高级选项配置：
- 忽略文件模板：根据项目类型选择（如Python项目选Python模板）
- 开源许可证：MIT/Apache等常见协议按需选择
- README文件：建议后续通过本地提交添加

2.2 仓库地址获取

创建成功后系统会显示两种访问地址：

HTTPS格式：https://托管平台域名/用户名/仓库名.git
SSH格式：git@托管平台域名:用户名/仓库名.git

选择建议：

新手推荐HTTPS（无需配置密钥）
企业项目建议SSH（传输更安全）

三、本地项目初始化

3.1 新项目初始化

目录结构准备：

mkdir my-project && cd my-project
# 创建基础目录结构（示例）
mkdir -p src/main tests docs
touch README.md .gitignore

Git环境初始化：

git init
# 生成初始提交记录
git add .
git commit -m "Initial commit with project structure"

3.2 已有项目迁移

清理历史版本：

# 检查现有版本控制文件
ls -a | grep -E '\.git|\.svn|\.hg'
# 存在则需彻底删除
rm -rf .git

重新初始化：

git init
# 创建.gitignore文件（示例内容）
echo -e "*.log\n*.tmp\nnode_modules/" > .gitignore
git add .
git commit -m "Migrate existing project to Git"

四、本地与远程同步

4.1 首次远程关联

# 使用HTTPS方式
git remote add origin https://托管平台域名/用户名/仓库名.git
# 使用SSH方式（需提前配置密钥）
git remote add origin git@托管平台域名:用户名/仓库名.git

验证配置：

git remote -v
# 应显示类似输出：
# origin  https://托管平台域名/用户名/仓库名.git (fetch)
# origin  https://托管平台域名/用户名/仓库名.git (push)

4.2 首次代码推送

# 推送所有分支（谨慎操作）
git push -u origin --all
# 推荐方式：仅推送主分支
git push -u origin main

常见问题处理：

认证失败：
- HTTPS方式：检查账号密码/个人访问令牌
- SSH方式：执行ssh -T git@托管平台域名测试连接
拒绝推送：
- 远程仓库非空：先执行git pull --rebase origin main
- 权限不足：联系仓库管理员添加写权限

五、持续开发工作流

5.1 标准开发流程

graph TD
    A[本地修改] --> B[git add]
    B --> C[git commit]
    C --> D{开发完成?}
    D -->|否| A
    D -->|是| E[git push]

5.2 分支管理策略

主分支保护：
- 设置main分支为受保护分支
- 配置必须通过Code Review才能合并
功能分支开发：
```bash

创建特性分支

git checkout -b feature/login-module

开发完成后推送到远程

git push origin feature/login-module


3. **合并请求流程**：
   - 在平台控制台创建Merge Request
   - 分配至少2名审核人员
   - 通过CI/CD流水线测试
   - 解决冲突后合并
# 六、高级功能应用
## 6.1 SSH密钥配置
1. **密钥生成**：
```bash
ssh-keygen -t ed25519 -C "your_email@example.com"
# 默认路径：~/.ssh/id_ed25519.pub

平台配置：
- 复制公钥内容（cat ~/.ssh/id_ed25519.pub）
- 在平台账户设置中添加SSH Key

6.2 子模块管理

# 添加子模块
git submodule add https://托管平台域名/用户名/subrepo.git libs/subrepo
# 更新子模块
git submodule update --init --recursive

6.3 标签管理

# 创建轻量标签
git tag v1.0.0
# 创建附注标签
git tag -a v1.0.0 -m "Release version 1.0.0"
# 推送到远程
git push origin v1.0.0

七、最佳实践建议

提交规范：
- 原子化提交：每个提交只解决一个问题
- 描述性信息：首行不超过50字符，详细说明另起段落
仓库维护：
- 定期清理无用分支（超过3个月未活动）
- 使用git gc优化仓库存储
安全实践：
- 敏感信息使用git secret加密
- 定期轮换个人访问令牌
- 启用2FA认证

通过本文的系统讲解，开发者可以完整掌握从项目初始化到持续集成的完整流程。建议结合实际项目进行多次实操练习，特别注意分支管理策略的选择和冲突解决技巧的积累。对于企业级项目，建议制定统一的代码规范和审核流程，确保代码质量和团队协作效率。

从零开始掌握代码托管：Gitee平台全流程操作指南