仓库管理

GitHub 仓库（Repository） 是远程 Git 项目的容器：代码、Issues、Actions、Wiki 都挂在仓库下。本课覆盖 git-github 路线图 的 creating-repositories、private-vs-public、cloning 节点。

本地 git init 在 git-essentials 已学；这里强调 在 GitHub 创建 → 本地关联 → 日常维护。

学习目标

• 在 GitHub 创建仓库并选择 public / private
• 用 HTTPS 或 SSH clone，理解 origin 含义
• 使用 .gitignore、README、License 初始化最佳实践

创建仓库

网页：New repository → 填名称、描述、是否 public。

选项	说明
Public	任何人可见；开源默认
Private	仅授权协作者可见；公司内项目常用
Add README	建议勾选，避免空仓首次 push 冲突
.gitignore	按语言选模板（Node、Java 等）
License	开源选 MIT / Apache-2.0；私有可 None

命令行创建（需 GitHub CLI gh）：

gh repo create my-demo --public --clone
cd my-demo

Clone 与远程

# SSH（推荐，已配密钥）
git clone git@github.com:you/my-demo.git

# HTTPS
git clone https://github.com/you/my-demo.git

cd my-demo
git remote -v
# origin  git@github.com:you/my-demo.git (fetch)
# origin  git@github.com:you/my-demo.git (push)

origin 是默认远程名；可 git remote add upstream ... 添加 fork 的上游（见 ghg-remote）。

本地已有项目推到 GitHub

cd existing-project
git init
git add .
git commit -m "chore: initial commit"
git branch -M main
git remote add origin git@github.com:you/existing-project.git
git push -u origin main

若远程已有 README，先 git pull origin main --rebase 再 push，避免 unrelated histories 错误。

仓库设置要点

• Settings → General：默认分支 main，是否允许 squash merge
• Settings → Collaborators：邀请协作者（组织场景见 ghg-org）
• Settings → Branches：分支保护规则（与 ghg-pr 联动）
• About：补全描述、Topics，方便检索

与 Actions / Pages 的关系

同一仓库可启用 GitHub Actions（.github/workflows/）和 GitHub Pages（ghg-pages）。CI 与静态站配置都写在仓库内，版本与代码一致。

练习

• 创建一个 public 练习仓，勾选 README + Node .gitignore
• SSH clone 到本地，改 README 后 push
• 在仓库 About 填描述，加 topic git-github-practice

小结

仓库 = 远程 Git + 协作功能入口。 下一课深入 commit 历史、message 规范与 GitHub 上的 diff 查看。