关于 Gist
Gist 提供了一种简单的方式与他人共享代码片段。每个 Gist 都是一个 Git 仓库,这意味着它可以被分叉和克隆。如果您在创建 Gist 时已登录 GitHub,Gist 将与您的账户关联,并在您访问 Gist 主页 时出现在您的 Gist 列表中。
Gist 可以是公开的或私密的。公开的 Gist 会出现在 Discover(发现) 中,用户可以在创建时浏览新 Gist。它们还可以被搜索,所以如果您希望他人找到并查看您的作品,可以将其设为公开。
私密 Gist 不会出现在 Discover 中,也无法被搜索,除非您已登录且是该私密 Gist 的作者。私密 Gist 并非完全私有。如果您将私密 Gist 的 URL 发送给朋友,他们可以查看。但如果有陌生人获取到该 URL,也同样可以查看您的 Gist。如果您需要将代码隐藏在窥探的目光之外,建议创建私有仓库。
对于 GitHub.com 和 GitHub Enterprise Cloud,GitHub 会自动扫描 私密 Gist 中的合作伙伴密钥,并在其密钥泄漏时通知相关合作伙伴。参见 关于合作伙伴的密钥扫描。
创建 Gist 后,无法将公开 Gist 转换为私密。但可以通过编辑 Gist 并将可见性更改为公开,将私密 Gist 设为公开。
当以下情况发生时,您将收到通知
- 您是某个 Gist 的作者。
- 有人在 Gist 中提到您。
- 您订阅了某个 Gist,方法是点击任意 Gist 顶部的 Subscribe(订阅)。
您可以将 Gist 固定到个人资料,以便其他人轻松看到。更多信息,请参见 将项目固定到个人资料。
您可以通过访问 Gist 主页 并点击 All Gists(所有 Gist) 来发现他人创建的公开 Gist。这会带您进入一个页面,按创建或更新时间排序显示所有 Gist。您也可以使用 Gist 搜索 按语言搜索 Gist。
由于 Gist 是 Git 仓库,您可以查看完整的提交历史及差异。您还可以对 Gist 进行分叉或克隆。更多信息,请参见 分叉和克隆 Gist。
您可以通过点击 Gist 顶部的 Download ZIP(下载 ZIP) 按钮来下载该 Gist 的 ZIP 文件。您可以在任何支持 JavaScript 的文本字段中嵌入 Gist,例如博客文章。要获取嵌入代码,请点击 Gist 的 Embed(嵌入) URL 旁的剪贴板图标。若要嵌入特定的 Gist 文件,请在 Embed URL 后添加 ?file=FILENAME。
Gist 支持映射 GeoJSON 文件。这些地图会在嵌入的 Gist 中显示,您可以轻松分享和嵌入地图。更多信息,请参见 处理非代码文件。
创建 Gist
请按以下步骤创建 Gist。
-
登录 GitHub。
-
前往您的 Gist 主页。
-
在右上角,点击 "+" 图标创建新 Gist。
-
可选地,在 “Gist description(Gist 描述)” 字段中输入对 Gist 的描述。
-
在 “Filename including extension(包含扩展名的文件名)” 字段中,为您的 Gist 输入文件名(包括文件扩展名)。
-
在文件内容字段中,输入 Gist 的文本内容。
-
可选地,要创建公开 Gist,请点击,然后点击 Create public gist。

-
点击 Create secret Gist 或 Create public gist。