Jelajahi Sumber

docs: 记录真实远端与分支选择

远端确定为公司自建 Gogs;主分支统一用 master —— Gogs 默认分支是 master 且 API 不允许普通用户改组织仓库设置,本地用 main 会导致别人 clone 出空目录(已实测)。
shencp 14 jam lalu
induk
melakukan
22cd386b08
1 mengubah file dengan 15 tambahan dan 4 penghapusan
  1. 15 4
      GIT.md

+ 15 - 4
GIT.md

@@ -183,7 +183,7 @@ python 90-工具/kb.py pull
 输出长这样:
 
 ```
-从 origin/main 拉取…
+从 origin/master 拉取…
 拉到 1 个新提交。原材料变化:新增 2 · 修改 0 · 删除 0 · 移动 0
   [NEW]     00-原材料/01-行业资料/远端新增报告.md
   [NEW]     00-原材料/03-课程素材/远端新案例.md
@@ -223,9 +223,20 @@ python 90-工具/kb.py pull
 
 ## 首次配置远端
 
+**本仓库已配置好**,远端是公司自建的 Gogs:
+
+```bash
+origin  https://gogs.goodpoint.top/Hyreal/course-factory.git
+分支    master(跟踪 origin/master)
+```
+
+> 为什么是 `master` 不是 `main`:Gogs 建库时默认分支就是 `master`,而且它的 API 不允许普通用户修改组织仓库的默认分支(PATCH 返回 404)。如果本地弄个 `main`,别人 `git clone` 下来会因为找不到 `master` 而得到一个空目录 —— 这个坑实测踩过。
+> 想改成 `main` 只有一条路:在 Gogs 网页「仓库设置 → 默认分支」里改,改完本地 `git branch -m master main && git push -u origin main`。
+
+如果要在别的机器上接进来:
+
 ```bash
-git remote add origin <你的本地 git 服务地址>
-git push -u origin main
+git clone https://gogs.goodpoint.top/Hyreal/course-factory.git
 ```
 
 如果是自建的 Gitea / GitLab,地址形如 `http://192.168.1.10:3000/team/course-factory.git`。
@@ -234,7 +245,7 @@ git push -u origin main
 ```bash
 git init --bare D:/git/course-factory.git
 git remote add origin D:/git/course-factory.git
-git push -u origin main
+git push -u origin master
 ```
 
 **不要推到公开 GitHub** —— 库里有客户名称、报价、内部方法论。