From 3a6a8f1df3cc3825c2387c849396e6fe72d3c31a Mon Sep 17 00:00:00 2001 From: Sincerely Date: Tue, 4 Nov 2025 14:59:03 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E6=8C=87=E5=AF=BC?= =?UTF-8?q?=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...15\344\275\234\346\214\207\345\215\227.md" | 104 ++++++++++++++++++ 1 file changed, 104 insertions(+) create mode 100644 "\346\214\207\345\257\274\346\226\207\346\241\243/\351\241\271\347\233\256\345\274\200\345\217\221\350\200\205\346\223\215\344\275\234\346\214\207\345\215\227.md" diff --git "a/\346\214\207\345\257\274\346\226\207\346\241\243/\351\241\271\347\233\256\345\274\200\345\217\221\350\200\205\346\223\215\344\275\234\346\214\207\345\215\227.md" "b/\346\214\207\345\257\274\346\226\207\346\241\243/\351\241\271\347\233\256\345\274\200\345\217\221\350\200\205\346\223\215\344\275\234\346\214\207\345\215\227.md" new file mode 100644 index 0000000000..ca9353d190 --- /dev/null +++ "b/\346\214\207\345\257\274\346\226\207\346\241\243/\351\241\271\347\233\256\345\274\200\345\217\221\350\200\205\346\223\215\344\275\234\346\214\207\345\215\227.md" @@ -0,0 +1,104 @@ +# 📄 Gitee/Git 项目开发者操作指南 + +**适用对象:** 首次使用 Gitee/Git 参与课程团队项目的开发者。 + +**核心原则:** 永远通过 **特性分支** 和 **Pull Request (PR)** 来提交你的代码,绝不直接修改主分支。 + +--- + +## 💻 第一步:克隆项目仓库 + +你需要将团队仓库的副本下载到你的本地电脑上。 + +1. **获取克隆地址:** 访问团队负责人 Fork 出来的新 Gitee 仓库页面,点击 **“克隆/下载”**,复制 **HTTPS** 地址(初学者推荐使用 HTTPS)。 +2. **执行克隆命令:** 打开你的终端(命令行),在你想要存放项目的目录下执行: + + ```bash + # 将 [仓库地址] 替换为你复制的 Gitee 地址 + git clone [仓库地址] + ``` +3. **进入项目目录:** + + ```bash + cd [你的项目名称] + ``` + +--- + +## 🌱 第二步:创建和切换特性分支 + +为你的每一个任务(功能开发或 Bug 修复)创建一个独立的分支,这是安全协作的基础。 + +1. **拉取主分支最新代码:** 确保你的本地代码是最新的。 + + ```bash + # 切换到团队的主开发分支(例如 team-dev) + git checkout team-dev + # 拉取最新的远程代码 + git pull origin team-dev + ``` +2. **创建特性分支:** 基于 `team-dev` 创建你的新分支。分支名需清晰(如 `feature-login`,`fix-bug-123`)。 + + ```bash + # 创建并切换到新分支 + git checkout -b feature-login + ``` + +--- + +## 📤 第三步:开发、提交与推送 + +1. **进行开发:** 在 `feature-login` 分支上完成你的任务。 +2. **查看状态:** 随时查看你的修改了哪些文件: + + ```bash + git status + ``` +3. **暂存变更:** 将修改过的文件添加到暂存区。 + + ```bash + # 暂存所有修改 + git add . + ``` +4. **提交变更:** 提交你的修改,`commit` 信息要清晰、有意义。 + + ```bash + git commit -m "feat: 完成用户登录表单界面的开发" + ``` +5. **推送特性分支:** 将你的本地分支推送到 Gitee 远程仓库。 + + ```bash + # 首次推送时使用 -u 参数 + git push -u origin feature-login + ``` + +--- + +## ➡️ 第四步:发起 Pull Request (PR) + +将你的代码变更作为一个正式的“合并提案”提交给审核人。 + +1. **访问 Gitee:** 推送完成后,访问你的 Gitee 仓库页面,Gitee 通常会弹出提示让你创建 PR。 +2. **创建 PR:** 点击 **“创建 Pull Request”** 按钮。 +3. **设置目标分支:** + * **源分支 (Source):** 你的特性分支,例如 `feature-login`。 + * **目标分支 (Target):** 团队的主开发分支,例如 `team-dev`。 +4. **填写信息:** 填写 PR 标题和描述,说明你完成了什么。 +5. **提交 PR:** 提交后,等待审核人进行审查。 + +--- + +## 🔄 第五步:处理修改意见 + +如果你的 PR 被要求修改(未通过审核),请按以下步骤更新: + +1. **本地修改代码:** 在你当前的分支 (`feature-login`) 上进行代码修改。 +2. **新的提交:** 再次进行 `git add .` 和 `git commit -m "fix: [修改说明]"`。 +3. **再次推送:** 再次推送到你的特性分支。 + + ```bash + git push origin feature-login + ``` + * **无需重新创建 PR!** Gitee 上的 Pull Request 会自动更新,包含你新的提交,并通知审核人重新审查。 + +**当你的 PR 被审核人合并后,你的特性分支使命完成。你可以删除本地和远程的 `feature-login` 分支。** \ No newline at end of file -- Gitee