上游 · 理解本功能前需先掌握的（1）：
下游 · 依赖/承接本功能的（0）：
暂无下游（建议学完它再进阶）
前置依赖包含从属概念升级流程承接
边方向 = 学习顺序（A→B 表示先学 A 再学 B）
为什么需要它
心智模型
有时候你只想分享一小段代码（比如一段函数、一个配置），为它开一个完整仓库太重了。Gist 就像「随手拍的代码便利贴」：把片段扔进去，生成一个链接，发给谁都能看，还能当迷你仓库用。
历史背景 · 它为什么诞生诞生于 2008
诞生代码片段分享需求长期被pastebin等工具简陋地满足（无版本控制、无法协作）。GitHub创始人Tom Preston-Werner 2008年在Ruby会议展示Gist，把pastebin理念升级为'每个gist是一个独立git仓库'。
功能介绍
Gists 是 GitHub 提供的代码片段分享服务，官方定义是 "Gists provide a simple way to share code snippets"——提供一种简单的方式分享代码片段。每个 Gist 本身就是一个 Git 仓库（Repository），所以它继承了很多 Git 特性：可以被 fork（复制一份到自己名下）、可以 clone 到本地、可以看到修改历史，还能嵌入到网页或文档里展示。Gist 分两种可见性：公开（Public）的 Gist 任何人都能搜索和查看；而 secret（私密）的 Gist 只有知道链接的人能看，注意它不是真正的私有，不能用于存放敏感数据。适合用来分享一段修复问题的代码、一个环境配置、一份脚本，或临时交换几行内容。你也可以把多个文件放进同一个 Gist，甚至让多个文件在一个片段里互相配合。
核心术语
代码片段（Code Snippet）分叉（Fork）克隆（Clone）公开（Public）私密（Secret）嵌入（Embed）
适用场景
- 当你想把一段代码片段分享给同事或朋友时
- 当你想在博客或论坛里嵌入一段带语法高亮的代码时
- 当你想保存一个常用的脚本或配置，随时取用和版本管理时
- 当你想 fork 别人的代码片段并改成自己的版本时
怎么操作（网页 vs 命令行 双轨）
🖱️ 网页操作 (GitHub.com)
- 打开 gist.github.com，在「Gist description」填描述、在「Filename」填文件名
- 粘贴代码内容，选择 Create public gist 或 Create secret gist
- 点击 Create Gist 后，复制生成的链接即可分享
⌨️ 命令行 (进阶)
`gh gist create my-script.py` # 创建一个 Gist`gh gist create --public file1.py file2.py` # 创建包含多文件的公开 Gist`gh gist list` # 列出你的所有 Gist`git clone https://gist.github.com/<gist_id>.git` # 把 Gist 克隆到本地
新手建议先从网页操作入手，熟悉概念后再尝试命令行。命令行是真实开发中更常用的方式。
与其他功能的关系
| 关系（前置依赖 / 包含从属 / 概念升级 / 流程承接） | 说明 |
|---|---|
| 概念升级版本控制基础（Version Control Basics） | gist 是微型 Git 仓库，可 fork/clone，先懂版本控制 |
官方文档
小结
SUMMARY
Gist 用最轻量的方式分享代码片段，本质是迷你 Git 仓库，支持 fork、clone、嵌入和公开/私密两种可见性。下一步：打开 gist.github.com，把你的第一段代码贴进去生成分享链接。