2.5 KiB
2.5 KiB
Git 仓库初始化全流程
环境信息
- Gitea 地址:
https://git.zeitvex.com - 仓库:
Robocon/RC_Legged - 远程 URL:
https://git.zeitvex.com/Robocon/RC_Legged.git - 认证方式: HTTPS + Personal Access Token
1. 前提条件
- Gitea 服务器已搭建并运行
- 在 Gitea 上已创建组织
Robocon和仓库RC_Legged - 本机已安装 Git（验证：
git --version） - 已生成 Personal Access Token（路径：Gitea → Settings → Applications → Generate New Token）
2. 初始化本地仓库
cd /path/to/RC_Legged
git init
git checkout -b main
3. 创建目录结构
mkdir -p 01_doc
mkdir -p 02_mechanical/CAD
mkdir -p 02_mechanical/STL
mkdir -p 02_mechanical/URDF
mkdir -p 03_hardware/PCB
mkdir -p 03_hardware/BOM
mkdir -p 03_hardware/datasheet
mkdir -p 04_firmware/motor_driver
mkdir -p 04_firmware/sensor_board
mkdir -p 05_software/rl_training/configs
mkdir -p 05_software/rl_training/envs
mkdir -p 05_software/rl_training/logs
mkdir -p 05_software/ros_ws/src
mkdir -p 05_software/ros_ws/scripts
mkdir -p 05_software/utils
mkdir -p 06_assets
4. 创建 .gitignore
文件内容参考 .gitignore，其中：
00_reference/
用于排除本地参考项目，不纳入版本管理。
5. 创建 README.md
项目首页，包含项目简介、目录结构、远程仓库地址。
6. 创建 项目规范.md
版本管理规范，包含：
- 分支策略：
main→main-nightly→task-* - Commit Message 格式：
[tag] 描述 - Code Review 流程
- 硬件测试规范
7. 首次提交
git add -A
git commit -m "[init] RC_Legged 项目初始化"
8. 关联远程仓库并推送
git remote add origin https://git.zeitvex.com/Robocon/RC_Legged.git
git push -u origin main
推送时 Git 会提示输入用户名和密码，密码处填入 Personal Access Token。
9. 配置分支保护
在 Gitea 网页上操作：
- 进入仓库 → Settings → Branches → Branch Protection
- 选择
main分支 - 启用保护规则（如禁止强制推送、禁止直接推送等）
10. 后续开发流程
# 拉取最新代码
git pull
# 创建任务分支
git checkout -b task-<name> main-nightly
# 日常提交
git add <file>
git commit -m "[tag] 描述"
git push origin task-<name>
# 合并到 main-nightly（在 Gitea 上创建 Pull Request）
# 稳定后合入 main
文档版本: v1.0 / 2026-06-25