Git 版本管理使用说明（Gitea）

代码已托管在 Gitea，Web 界面可看历史、diff、回滚。 仓库地址：https://git.ruiguo.wang/wangruiguo/OnebotCatalog.git Web 界面：https://git.ruiguo.wang

一、日常提交（改动后存一版）

git add -A
git commit -m "说明这次改了什么"
git push

三步搞定：暂存 → 提交（本地留档）→ 推送（上传到服务器备份）。

二、看历史 / 看改了啥

git log --oneline          # 提交列表（短格式）
git log -p                 # 每次提交的详细改动
git status                 # 当前有哪些文件改动未提交
git diff                   # 具体改了什么内容

更直观：直接浏览器打开 https://git.ruiguo.wang 看，图形化看历史、diff、每个文件。

三、回滚（改坏了想退回）

# 1. 查看历史，找到要退回的版本号（commit 前 7 位）
git log --oneline

# 2. 退回到某个版本（保留后续改动在工作区）
git checkout <版本号> -- <文件名>

# 3. 整个仓库回到某个版本（危险，会丢弃之后所有提交，慎用）
git reset --hard <版本号>

最安全：在 Web 界面找到旧版本的某个文件 → 直接下载覆盖，再 commit。

四、新电脑拉取代码

git clone https://git.ruiguo.wang/wangruiguo/OnebotCatalog.git

之后改代码提交推送即可，和上面的日常提交一样。

⚠️ 重要：哪些文件不入 git（.gitignore 已配好）

以下大文件不会上传到 Gitea（版本管理只存代码和文档）：

PDF、Excel、报价单
STEP/STP/IGES/STL 数模文件（4138 个，体积大）
exe/dll 编译产物、.opc 数据包
图片（手册页 PNG 等）

这些大文件靠其他方式备份（如直接拷盘/群晖同步），git 只管"代码 + 文档 + 配置"。

五、常见问题

问题	解决
push 报认证失败	用 Gitea 账号密码登录，或用 SSH 地址 `ssh://git@git.ruiguo.wang:40846/wangruiguo/OnebotCatalog.git`
提示 ROOT_URL 不匹配	用 `https://git.ruiguo.wang` 访问，不要用 IP 访问
忘了提交了哪些	`git status` + `git log`

2.2 KiB Raw Permalink Blame History Unescape Escape