跳至主要内容

创建代码片段的永久链接

您可以为特定文件的特定版本中的某行或某段代码创建永久链接。

谁可以使用此功能?

Markdown 可在 GitHub 网页界面中使用。

链接到代码

此类永久链接仅在其来源的仓库中渲染为代码片段。在其他仓库中,永久链接代码片段将显示为 URL。此功能不适用于 Markdown 文件,仅在评论中可用。

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 上,导航至仓库的主页面。

  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

您可以通过在文件的 URL 末尾添加 ?plain=1 参数来加载 Markdown 文件而不进行渲染。例如,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 行。

延伸阅读

© . This site is unofficial and not affiliated with GitHub, Inc.