Skip to main content

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

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

谁可以使用此功能?

Markdown 可用于 GitHub Web 界面。

链接到代码

此类永久链接仅在其起源仓库中呈现为代码段。 在其他仓库中,永久链接代码段将呈现为 URL。

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

Tip

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

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

  2. 找到要链接的代码:

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

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

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

  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 行。

延伸阅读