provideDefinition 方法必须返回 Location 或 Location[]，不可返回 null、undefined 以外的 falsy 值；单位置用 new vscode.Location(uri, range)，多位置用数组；uri 必须为 vscode.Uri 实例，range 必须为 vscode.Range 实例，行列号从 0 开始；注册时 language 和 scheme 需精确匹配文档属性；远程文件需适配 'vscode-remote' scheme；模块路径解析须自行实现，推荐 use require.resolve。
provideDefinition 方法必须返回 Location 或 Location[]
VSCode 不接受 null、undefined 或空数组以外的 falsy 值作为跳转结果。如果符号没找到，直接 return undefined（不是 null）；如果找到了一个位置，返回 new vscode.Location(uri, range)；多个定义（如重载函数）则返回 [loc1, loc2] 数组。
常见错误是返回了 { uri, range } 对象字面量，或漏写 vscode.Location 构造函数 —— VSCode 会静默忽略，表现为“点了没反应”，控制台也无报错。
-
vscode.Location的uri必须是vscode.Uri.file(...)或vscode.Uri.parse(...)构造的合法 URI，不能是字符串路径 -
range必须是vscode.Range实例，不能是{ start, end }普通对象 - 行号和列号从 0 开始，
Position(0, 0)表示首字符，别用 1-based 坐标
注册 DefinitionProvider 时 language 和 scheme 要匹配实际文档
如果你只支持 package.json 文件，注册时应指定 { scheme: 'file', language: 'json' }，而不是笼统地写 '*'。VSCode 会根据当前文档的 document.languageId 和 document.uri.scheme 匹配 provider。
容易踩的坑：
- 误以为
language: 'javascript'能响应.ts文件 —— TypeScript 文件默认是language: 'typescript'，需单独注册或使用['javascript', 'typescript'] - 处理远程文件（如 WSL、SSH）时，
scheme可能是'vscode-remote'，此时scheme: 'file'的 provider 不生效 - 自定义语言插件未在
package.json的contributes.languages中声明id，会导致language匹配失败
vscode.executeDefinitionProvider 命令可用于调试跳转逻辑
不必每次都点鼠标测试，可以在插件代码里调用内置命令验证返回值：
const definitions = await vscode.commands.executeCommand<vscode.Location[]>( 'vscode.executeDefinitionProvider', document.uri, new vscode.Position(line, column) );
这个命令绕过 UI 触发流程，直接调用所有已注册的 provideDefinition，返回原始结果。适合单元测试或开发时快速确认解析逻辑是否命中目标位置。
- 注意：该命令不触发
token取消逻辑，调试时无需关心取消信号 - 若返回空数组，说明没有 provider 匹配，或 provider 返回了
undefined - 若抛出异常，堆栈会指向你插件中
provideDefinition内部，比 UI 点击更易定位问题
复杂跳转（如模块解析）必须自己处理路径解析和文件存在性
VSCode 不帮你 resolve 模块路径或读取 node_modules。比如在 import { foo } from 'lodash' 上触发跳转，你的 provideDefinition 需要：
- 提取字符串字面量
'lodash' - 根据当前
document.uri.fsPath向上查找node_modules/lodash或package.json#exports - 检查
lodash/index.d.ts或lodash/package.json#types是否存在 - 构造对应文件的
vscode.Uri.file(...)和入口范围（如export declare function foo(...)所在行）
这里最容易被忽略的是 Windows 路径分隔符、软链接处理、PnP（Plug’n’Play）包管理器兼容性 —— 直接拼接字符串 + fs.existsSync 在跨平台或现代前端项目中大概率失效。建议用 require.resolve('lodash')（Node.js 环境）或 createRequire 配合 import.meta.url 安全解析。
