创建指向代码片段的永久链接

您可以创建指向特定文件或拉取请求的特定版本中的特定行或行范围的永久链接。

本文中

链接到代码

这种类型的永久链接仅在代码片段来源的存储库中呈现为代码片段。在其他存储库中，永久链接代码片段将呈现为 URL。

Screenshot of an issue comment. A code snippet has a header that lists the file name and line numbers, and a body that lists the code on those lines.

提示：要为整个文件创建永久链接，请参阅“获取指向文件的永久链接”。

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 找到您要链接到的代码

    • 要链接到文件中的代码，请导航到该文件。
    • 要链接到拉取请求中的代码，请导航到拉取请求并单击 已更改的文件。然后，浏览到包含您要在评论中包含的代码的文件，然后单击查看。

  3. 选择是选择单行还是范围。

    • 要选择单行代码，请点击行号以高亮显示该行。
    • 要选择一段代码，请点击代码段第一行的行号以高亮显示该行。然后，将鼠标悬停在代码段最后一行上，按下 Shift 键，并点击行号以高亮显示整个代码段。

  4. 在选中行或代码段的左侧，点击 . 在下拉菜单中，点击 **复制永久链接**。

    Screenshot of a file, with 8 lines selected. To the left of the first selected line, a button labeled with a kebab icon is outlined in dark orange.

  5. 导航到您想要链接到代码片段的对话。

  6. 将您的永久链接粘贴到评论中，然后点击 **评论**。

链接到 Markdown 文件

您可以通过加载未渲染 Markdown 的 Markdown 文件来链接到 Markdown 文件中的特定行。要加载未渲染的 Markdown 文件，您可以在文件 URL 的末尾使用 `?plain=1` 参数。例如，`github.com/<organization>/<repository>/blob/<branch_name>/README.md?plain=1`。

您可以像在代码中一样链接到 Markdown 文件中的特定行。在 URL 的末尾添加 `#L` 和行号。例如，`github.com/<organization>/<repository>/blob/<branch_name>/README.md?plain=1#L14` 将高亮显示纯文本 README.md 文件中的第 14 行。

进一步阅读