跳至主要内容

创建 Gist

您可以创建两种 Gist:公开的和私密的。如果您准备与全世界分享您的想法,请创建公开的 Gist;如果您不准备分享,请创建私密的 Gist。

关于 Gist

Gist 提供了一种简单的方法来与他人共享代码片段。每个 Gist 都是一个 Git 仓库,这意味着它可以被 fork 和克隆。如果您在创建 Gist 时已登录 GitHub,则该 Gist 将与您的帐户关联,您可以在导航到您的Gist 主页时在您的 Gist 列表中看到它。

Gist 可以是公开的或私密的。公开的 Gist 会显示在发现页面中,人们可以在创建 Gist 时浏览新的 Gist。它们也可以搜索,因此如果您希望其他人找到并查看您的作品,您可以使用它们。

秘密 Gist 不会出现在 发现 页面中,并且除非您已登录且是该秘密 Gist 的作者,否则无法搜索到。秘密 Gist 并非私密。如果您将秘密 Gist 的 URL 发送给朋友,他们将能够看到它。但是,如果您不认识的人发现了该 URL,他们也能够看到您的 Gist。如果您需要保护您的代码不被窥探,您可能需要改而 创建一个私有仓库

创建 Gist 后,您无法将其从公开更改为秘密。但是,可以通过编辑 Gist 并将可见性更新为公开来公开秘密 Gist。

您会在以下情况下收到通知:

  • 您是某个 Gist 的作者。
  • 有人在 Gist 中提及您。
  • 您订阅了某个 Gist(方法是在任何 Gist 的顶部点击**订阅**)。

您可以将 Gist 固定到您的个人资料,以便其他人可以轻松地看到它们。更多信息,请参阅“将项目固定到您的个人资料”。

您可以通过访问 Gist 首页 并点击**所有 Gist** 来发现其他人创建的公开 Gist。这将带您到一个页面,其中显示所有按创建时间或更新时间排序的 Gist。您还可以使用 Gist 搜索 按语言搜索 Gist。

由于 Gist 是 Git 仓库,您可以查看其完整的提交历史记录,包括差异。您还可以复制或克隆 Gist。更多信息,请参阅“复制和克隆 Gist”。

您可以通过点击 Gist 顶部的**下载 ZIP** 按钮下载 Gist 的 ZIP 文件。您可以将 Gist 嵌入到任何支持 JavaScript 的文本字段中,例如博客文章。要获取嵌入代码,请点击 Gist 的**嵌入** URL 旁边的剪贴板图标。要嵌入特定 Gist 文件,请在**嵌入** URL 后附加?file=FILENAME

Gist 支持映射 GeoJSON 文件。这些地图显示在嵌入式 Gist 中,因此您可以轻松地共享和嵌入地图。更多信息,请参阅“使用非代码文件”。

创建 Gist

请按照以下步骤创建 Gist。

您也可以使用 GitHub CLI 创建 Gist。更多信息,请参阅 GitHub CLI 文档中的“gh gist create”。

或者,您可以将文本文件从桌面直接拖放到编辑器中。

  1. 登录 GitHub。

  2. 导航到您的 Gist 首页

  3. 可选:在“Gist 描述”字段中,为您的 Gist 输入描述。

  4. 在“包含扩展名的文件名”字段中,为您的 Gist 输入文件名,包括文件扩展名。

  5. 在文件内容字段中,输入您的 Gist 文本。

  6. 可选:要创建公开 Gist,请点击,然后点击**创建公开 Gist**。

    Screenshot of the visibility dropdown menu for a new gist. Next to a button labeled "Create secret gist", a dropdown icon is outlined in dark orange.

  7. 点击**创建秘密 Gist** 或**创建公开 Gist**。