DocumentLink 能跳转到源码行号，但必须注册 DocumentLinkProvider 并返回含有效 vscode://file/ 协议 URL 的 DocumentLink，其中 target 必须包含 line 和 character 参数（行号从 0 开始），且路径需为绝对路径、正斜杠分隔、与工作区根目录一致，否则跳转失效或错位。
DocumentLink 能不能跳转到源码行号
能，但必须满足两个硬性条件：插件主动注册 DocumentLinkProvider，且返回的 DocumentLink 对象中 target 字段是有效的 vscode://file/ 协议 URL，并包含 line 和 character 查询参数。只填路径不行，缺了行号参数 VSCode 就当普通文件打开，不会定位。
为什么点击 DocumentLink 没反应或跳错位置
常见原因不是代码没写，而是协议拼错或路径不一致：
-
target写成file:///或相对路径（如./src/index.ts），VSCode 会忽略跳转逻辑 - 路径用了 Windows 风格反斜杠
\，但在 macOS/Linux 上解析失败；应统一用正斜杠或vscode.Uri.file().toString()生成 - 行号从 0 开始计数，但你的源码行号是从 1 开始取的——
Range构造时new vscode.Position(0, 0)才对应第 1 行第 1 列 - 工作区根目录没对齐：
vscode.workspace.workspaceFolders[0].uri.fsPath和你拼的路径前缀不一致，导致vscode://协议解析后路径错位
如何安全生成可跳转的 DocumentLink target
别手拼字符串，用 VSCode 提供的 URI 工具链：
- 用
vscode.Uri.file(filePath).with({ fragment: `L${lineNumber}` }).toString()—— 这是最简方式，L23会被自动识别为第 23 行 - 更精确控制列号：用
.with({ query: `line=${lineNumber}&column=${charOffset}` })，注意column是从 0 开始的字符偏移量 - 确保
filePath是绝对路径，可通过path.resolve(workspaceFolder, relativePath)补全 - 如果链接目标不在当前工作区（比如 node_modules 里的声明文件），需确认该路径已被 VSCode 索引，否则跳转会静默失败
调试 DocumentLinkProvider 时容易漏掉的点
Provider 的 provideDocumentLinks 方法返回空数组或 null，VSCode 就完全不渲染下划线；但即使返回了链接，也不代表它能点——得看 console 是否报错：
- 打开开发者工具（Help → Toggle Developer Tools），筛选
ERR或documentLink，常能看到 “Invalid URI” 或 “File not found” - 在 Provider 函数里加
console.log(link.target)，复制出来手动粘贴到浏览器地址栏，看是否触发 VSCode 启动并跳转（前提是 VSCode 已设为默认处理vscode://协议） - Windows 用户特别注意：如果 VSCode 安装在非系统盘（比如 D:\Code），而协议里路径还是 C:\，就会跳到空白编辑器——此时要检查
filePath来源是否被硬编码
