关于 gists
Gist 提供了一种与他人共享代码片段的简单方法。 每个 gist 都是一个 Git 仓库,意即可以复刻和克隆。 如果创建 gist 时已登录 GitHub,则该 gist 将与你的帐户关联,导航到 gist 主页、http(s)://[hostname]/gist 或 http(s)://gist.[hostname](如果启用了子域) 时,你会在 gist 列表中看到它。
Gist 可以为公共或机密。 公共 gist 会在 发现、http(s)://[hostname]/gist/discover 或 http(s)://gist.[hostname]/discover(如果启用了子域) 中显示,用户可以在创建时浏览新的 gist。 它们也可供搜索,因此,如果你希望其他人查找和查看你的工作,便可使用公共 gists。
机密 Gist 不会显示在 发现、http(s)://[hostname]/gist/discover 或 http(s)://gist.[hostname]/discover(如果启用了子域) 中,并且不可搜索,除非你已登录并且是机密 Gist 的作者。 秘密 Gist 不是专用 Gist。 如果你将机密 gist 的 URL 发送给朋友,他们将能够看到该 gist。 但是,如果你不认识的人发现了该 URL,他们也能看到你的 gist。 如果需要将代码保密,可能需要改为创建专用存储库。
对于 GitHub.com 和 GitHub Enterprise Cloud,GitHub 会自动扫描机密 gist 中的合作伙伴机密,并在发现任何合作伙伴机密泄露时通知相关合作伙伴。
创建 gist 后,无法将其从“公共”改为“机密”。但是,可以通过编辑 gist 并将可见性更新为公共来公开机密 gist。
如果你的站点管理员禁用了专用模式,你也可以使用匿名 gists,可以是公共 gists 或秘密 gists。
你在以下情况下会收到通知:
- 你是新 gist 的作者。
- 有人在 gist 中提及你。
- 通过单击任何 gist 顶部的“订阅”,即可订阅该 gist。
你可以在个人资料中置顶 Gist,使其他人更容易看到它们。 有关详细信息,请参阅“AUTOTITLE”。
通过转到 gist 主页、http(s)://[hostname]/gist 或 http(s)://gist.[hostname](如果启用了子域) 并单击“所有 Gist”,可以发现其他人创建的公共 gist。 将会显示所有 gists 存储的页面,gist 按创建或更新时间显示。 你也可以通过 Gist 搜索、http(s)://[hostname]/gist/search 或 http(s)://gist.[hostname]/search(如果启用了子域) 按语言搜索 gist。 Gist 搜索使用与代码搜索相同的搜索语法。
由于 gists 是 Git 仓库,因此你可以查看其整个提交历史记录,包括差异。 你也可以复刻或克隆 gists。 有关详细信息,请参阅“AUTOTITLE”。
通过单击 gist 顶部的“下载 ZIP”按钮,可以下载该 gist 的 ZIP 文件。 你可以将 gist 嵌入到支持 JavaScript 的任何文本字段中,如博客文章。 要获取嵌入代码,请单击 gist 的嵌入 URL旁边的剪贴板图标。 要嵌入特定的 gist 文件,请在嵌入 URL 后追加 。
创建 Gist
按照以下步骤创建 gist。
注意
你也可以使用 GitHub CLI 创建 Gist。 有关更多信息,请参阅 GitHub CLI 文档中的 。
或者,也可以将桌面上的文本文件直接拖放到编辑器中。
-
登录 GitHub。
-
导航到 gist 主页、
http(s)://[hostname]/gist或http(s)://gist.[hostname](如果启用了子域)。 -
在右上角,单击“+”图标以创建新的 Gist。
-
(可选)在“Gist 描述”字段中,键入 Gist 的描述。
-
在“文件名(包括扩展名)”字段中,键入 Gist 的文件名,包括文件扩展名。
-
在“文件内容”字段中,键入 Gist 的文本。
-
(可选)要创建公共 gist,请单击 ,然后单击“创建公共 gist”。

-
单击“创建机密 Gistt ”或“创建公共 gist”。