团队 Git 使用手册（git.yami.ink 新手版）
适用对象：第一次用 Git 的同学。不用先去学 Git，照着本文操作就行。 遇到任何报错：整屏复制报错，发给 AI（Trae / Claude / ChatGPT），照它说的做。
〇、先记住三句话
- 每天开工先
git pull - 改完代码
git add .→git commit -m "说明"→git push - 报错不可怕，复制给 AI 兜底
下面是详细步骤，第一次照着做一遍，之后就是肌肉记忆。
一、账号设置（登录后先做这两件事）
- 平台地址：https://git.yami.ink （账号由管理员统一创建，无需注册）
用管理员给你的用户名和初始密码登录后，点右上角头像 → 「设置」：
1. 改密码
在左侧 「账号」 页最上方「修改密码」：填旧密码 → 设一个你记得住的新密码。
2. 改邮箱（自助，立即生效）
同一页往下找 「管理邮箱地址」：
- 底部输入框填你的常用邮箱 → 点「添加」
- 不需要收验证邮件，加完立即生效
- 把初始化的旧邮箱删掉（点邮箱旁的删除按钮）
注意两点：
- 这个邮箱要和你后面
git config里填的邮箱保持一致（见第二节），这样你的提交在网页上才会显示你的头像和名字- 这页最底下有「删除账号」红色按钮，别乱点
3. 界面是英文？切中文
头像 → 设置 → 「外观」（Appearance） → Language 选 简体中文 → 保存。
4. 忘记密码怎么办
平台没配邮件服务，网页上「忘记密码」点不出结果，直接找管理员重置。
二、本地准备（每台电脑只做一次）
1. 安装 Git
下载：https://git-scm.com/download/win —— 安装时一路「Next」到底即可。
2. 告诉 Git 你是谁
打开 Trae / VSCode 的终端（或开始菜单里的「Git Bash」），粘贴运行（引号里换成自己的）：
git config --global user.name "你的名字（拼音或网名）"
git config --global user.email "你在第一节点设置的邮箱"
检验：运行 git config --global --list，能看到这两行就 OK。
三、第一次拿代码（clone）
- 在网页打开要协作的仓库，点绿色 「代码」 按钮，复制 HTTPS 地址，形如：
https://git.yami.ink/组织名/仓库名.git - 在电脑上选一个放代码的文件夹，在该文件夹打开终端，执行：
git clone 刚才复制的地址
- 第一次会弹出登录框：输入 git.yami.ink 的用户名和密码，Windows 会记住，以后免输。
完成后文件夹里多出一个和仓库同名的目录，代码就在里面。
四、日常上传（每天就是这一套）
节奏口诀：开工先 pull，改完 add + commit，收工 push。
cd 仓库文件夹 # 进入 clone 下来的代码目录
git pull # ① 拉取别人的最新改动（每天开工第一步！）
# ......正常写你的代码......
git add . # ② 把改动放入暂存区（. 表示全部文件）
git commit -m "一句话说明改了什么，例如：修复登录按钮不响应" # ③ 打包成一次提交
git push # ④ 上传到 git.yami.ink
push 成功后，刷新网页仓库页面就能看到你的提交和名字。
为什么开工要先 pull？ 别人可能在你没干活的时候推了新代码，先 pull 拿到最新版，再改才不会打架。
五、不装 Git 也能干的活（网页端）
- 看代码：仓库页直接点文件浏览
- 只想下载看，不参与协作：绿色「代码」按钮 → 「下载 ZIP」
- 看谁改了什么：仓库页「提交」标签页 = 全部历史记录
- 改个小文件（文档类）：进入文件 → 「编辑」→ 改完在底部填提交说明 → 「提交变更」
- 报 bug / 提需求：仓库页「议题（Issues）」→ 「创建议题」，标题写清现象，正文贴截图和复现步骤
六、常见报错对照表
| 报错关键词 | 意思 | 怎么办 |
|---|---|---|
Please tell me who you are |
没做第二节的身份配置 | 回去做 git config 那两条命令 |
Authentication failed |
用户名或密码错 | 确认输的是用户名（不是邮箱）；密码改过就用新密码 |
! [rejected] ... fetch first |
服务器上有你本地没有的提交 | 先 git pull，然后重新 push |
CONFLICT (content) |
你和别人改了同一个地方 | 别慌，把整屏报错发给 AI，按它说的做 |
not a git repository |
当前文件夹不是代码仓库目录 | cd 到 clone 下来的那个文件夹里 |
nothing to commit |
没有改动可提交 | 检查文件是否保存、是否在正确目录 |
七、三条纪律 + 万能兜底
- 每天开工先
git pull - 尽量各改各的文件，避免多人同时改同一个文件
- push 前先
git pull；push 被拒就先 pull 再试 - 万能兜底：整屏复制报错 + 说一句你刚才在干什么 → 发给 AI → 照做。还搞不定，找管理员。