如何在Java、Groovy、Kotlin源码中创建非URL可点击跳转链接？

IntelliJ确实支持多种语法，能让你在Java/Groovy/Kotlin的注释里轻松跳转到Markdown、AsciiDoc这类非源文件，以下是几种实用方案：

1. 直接写本地文件路径（通用所有注释类型） #

不管是单行注释、多行注释还是Javadoc/KDoc，直接在注释里写文件的相对路径（相对于项目根目录）或绝对路径，IntelliJ都会自动识别，按下Ctrl+点击就能跳转：

// 参考需求文档：docs/requirements/feature-spec.md
/**
 * 架构设计详情见：docs/design/system-architecture.adoc
 */

// 查看API说明：docs/api/openapi.yaml
/**
 * 数据模型定义参考 [docs/models/data-schema.json]
 */

// 部署指南：docs/deployment/setup-guide.md
/**
 * 配置说明见 docs/config/application-settings.adoc
 */

2. Javadoc/KDoc的标准语法扩展 #

对于Javadoc，你可以用{@link}或{@linkplain}标签来包裹文件路径，IntelliJ会识别并支持跳转：

/**
 * 详细设计文档：{@link docs/design/module-design.adoc}
 * 用户手册：{@linkplain docs/manual/user-guide.md}
 */

KDoc则支持用方括号包裹路径，和Markdown链接语法一致：

/**
 * 核心流程说明见 [docs/flow/core-process.md]
 */

3. 自定义链接前缀（增强可读性） #

如果想让链接更清晰易识别，可以通过IntelliJ的自定义文件链接规则来配置：

• 打开Settings > Tools > File Link Providers
• 点击+添加新规则，设置：
  • Prefix：比如adoc:、md:
  • Path Pattern：比如docs/$FILE$（$FILE$会替换成前缀后的文件名）
    配置完成后，就能用更简洁的语法跳转：

// 架构文档：adoc:system-architecture.adoc
// 用户手册：md:user-guide.md

注意事项 #

• 优先使用相对路径，避免项目移动后链接失效
• 如果文件路径错误，IntelliJ会高亮显示无效链接
• 安装对应插件（如AsciiDoc插件）后，跳转至AsciiDoc/Markdown文件时可直接预览渲染效果

内容的提问来源于stack exchange，提问作者Thorbjørn Andersen - UFST