Skip to main content

此版本的 GitHub Enterprise Server 将于以下日期停止服务 2026-08-25. 已停止发布的版本不受支持。 即使针对重大安全问题,也不会发布补丁。 若要获得更好的性能、改进的安全性和 GitHub Enterprise Server 中的新功能,请参阅升级过程的 Overview。 如需升级帮助,请联系 GitHub Enterprise 支持。

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

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

谁可以使用此功能?

Markdown 可用于 GitHub Web 界面。

在本文中

链接到代码

此类永久链接仅在其起源仓库中呈现为代码段。 在其他仓库中,永久链接代码段将呈现为 URL。 这不适用于 Markdown 文件,仅适用于注释。

问题注释的屏幕截图。 代码片段具有一个列出文件名和行号的标头,以及一个列出这些行上的代码的正文。

提示

若要为整个文件创建永久链接,请参阅“获取文件的永久链接”。

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 找到要链接的代码:

    • 要链接到文件中的代码,请导航到该文件。
    • 若要从拉取请求链接到代码,请导航到拉取请求并单击 “Files changed”。 然后浏览到含有要包含在注释中的代码的文件,并单击“View”
  3. 决定是选择一行还是一个范围。

    • 要选择单行代码,请单击行号以高亮显示该行。
    • 要选择代码范围,请单击范围内第一行的行号以高亮显示代码行。 然后,将鼠标停在代码范围的最后一行,按 Shift,再单击行号以突出显示范围。
  4. 在行或一系列行的左侧,单击 。 在下拉菜单中,单击“复制永久链接”。

    一个文件的屏幕截图,其中选中了 8 行。 在第一个选定行的左侧,一个标有“烤肉串”图标的按钮以深橙色标出。

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

  6. 将永久链接粘贴到注释中,然后单击“注释”。

链接到 Markdown

您可以通过加载 Markdown 文件而不进行 Markdown 渲染来链接到 Markdown 文件中的特定行。 要在不呈现的情况下加载 Markdown 文件,可以在文件的 URL 末尾使用 ?plain=1 参数。 例如,github.com/<organization>/<repository>/blob/<commit_SHA>/README.md?plain=1

您可以在代码中以同样的方式链接到 Markdown 文件中的特定行。 在 URL 末尾附加 #L 以及行号。 例如,github.com/<organization>/<repository>/blob/<commit_SHA>/README.md?plain=1#L14 将在纯文本 README.md 文件中突出显示第 14 行。

其他阅读材料