上游 · 理解本功能前需先掌握的（1）：
下游 · 依赖/承接本功能的（11）：
协作者权限问题讨论区维基自动化部署：GitHub Actions依赖安全：DependabotStar 与 Watch编程接口：GitHub REST API云端开发环境：GitHub Codespaces仓库骨架远程仓库
前置依赖包含从属概念升级流程承接
边方向 = 学习顺序（A→B 表示先学 A 再学 B）
为什么需要它
心智模型
仓库（repository）是 GitHub 上最基本也最核心的元素：一个项目就是放在一个仓库里，代码、文件、修订历史都装在里面。就像每个项目需要一个文件夹，GitHub 上每个项目都需要一个仓库。学会创建仓库，你的 GitHub 之旅才算真正开始。
历史背景 · 它为什么诞生诞生于 2008
诞生Git缺集中托管与发现层，GitHub 2008年4月上线即以仓库创建为入口，让代码可公开访问、可被fork与协作，仓库成为协作与项目发现的基本单元。
功能介绍
官方文档称仓库为'GitHub 上最基本的元素'：一个仓库（repository，简称 repo）包含一个项目的所有文件（代码、文档、图片等）以及完整的修订历史（revision history）。在网页上点击 'New repository' 即可创建，关键选项包括：设置仓库名和描述、选择公开（public）还是私有（private）、以及是否初始化 README、添加 .gitignore、选择开源许可证（license）。README 用来介绍项目，.gitignore 用来忽略不需要版本控制的文件（如编译产物），许可证（license）决定别人能否合法复用你的代码。这三个选项建议创建时一并勾选，避免日后手动补建的麻烦。
核心术语
仓库（repository）：存放项目文件与修订历史的容器公开/私有（public/private）：仓库对他人是否可见初始化（initialize）：创建仓库时预置初始文件修订历史（revision history）：所有修改的完整记录许可证（license）：声明他人可如何使用你的代码
适用场景
- 当你开始一个新项目、想要一个存放代码和历史的'家'时
- 当你想公开分享自己的作品、让其他人查看或参与时
- 当你想用私有仓库保存还不打算公开的代码时
- 当你想为项目添加 README、许可证或忽略规则时
怎么操作（网页 vs 命令行 双轨）
🖱️ 网页操作 (GitHub.com)
- 登录 GitHub 后点击右上角 '+' 图标，选择 'New repository'
- 填写仓库名和描述，选择 Public（公开）或 Private（私有）
- 勾选 'Add a README file'，可选添加 .gitignore 和许可证
- 点击 'Create repository' 完成创建
⌨️ 命令行 (进阶)
mkdir my-first-repo && cd my-first-repogit init # 在本地初始化一个 Git 仓库git add README.md && git commit -m "first commit" # 首次提交git remote add origin <仓库地址> && git push -u origin main # 关联并推送
新手建议先从网页操作入手，熟悉概念后再尝试命令行。命令行是真实开发中更常用的方式。
与其他功能的关系
| 关系（前置依赖 / 包含从属 / 概念升级 / 流程承接） | 说明 |
|---|---|
| 前置依赖账号与个人主页（Account & Profile） | 需要注册账号才能创建仓库 |
| 流程承接仓库骨架（Repository Skeleton） | 创建仓库后可添加 README/License/.gitignore 骨架文件 |
| 流程承接远程仓库（Remote Repository） | 创建仓库后配置远程地址 origin |
| 概念升级Star 与 Watch（Star & Watch） | 理解仓库后才知道如何浏览与关注他人仓库 |
| 前置依赖协作者权限（Collaborator Permission） | 仓库所有者可添加协作者并授权 |
| 前置依赖问题（Issue） | 在仓库中创建 issue 追踪工作 |
| 前置依赖讨论区（Discussions） | 在仓库中开启讨论区 |
| 前置依赖维基（Wiki） | 为仓库启用维基文档 |
| 前置依赖自动化部署：GitHub Actions（动作） | Actions workflow 在仓库中运行，先有仓库 |
| 前置依赖依赖安全：Dependabot（依赖机器人） | Dependabot 分析仓库依赖，先有仓库 |
| 概念升级编程接口：GitHub REST API（接口） | API 编程化操作仓库及全部功能，先有仓库对象 |
| 概念升级云端开发环境：GitHub Codespaces（代码空间） | 为仓库创建云端开发环境在线开发 |
官方文档
小结
SUMMARY
仓库是 GitHub 上项目的最小单元，创建时勾选 README、.gitignore 和许可证能一步到位。创建完仓库，你已经有了一间'毛坯房'。下一步：把它克隆到本地电脑上开始装修。