VS Code编写JavaScript时定义跳转功能失效的原因是什么？

以下是最常见的失效原因及对应适配方案：

• 静态类型推导限制：VS Code 对JS的语义分析完全依赖内置的TypeScript语言服务做静态推导，如果你的something属性是通过动态赋值、未标注类型的解构赋值、运行时挂载的全局属性生成的，静态分析阶段无法识别属性的定义位置，就会出现跳转失效。
  适配方案：给相关变量添加JSDoc类型标注，明确属性结构，示例：

  /**
   * @typedef {Object} CustomObj
   * @property {Function} something
   */
  /** @type {CustomObj} */
  const myObj = getDynamicObj()
  myObj.something() // 此时即可正常跳转
  

• 缺少项目配置文件：如果项目根目录没有jsconfig.json或tsconfig.json，VS Code会将每个JS文件视为独立单元，不会做跨文件的语义关联，跨文件定义、引用的识别都会失效。
  适配方案：在项目根目录新增jsconfig.json，基础配置参考：

  {
    "compilerOptions": {
      "target": "ESNext",
      "module": "ESNext",
      "checkJs": true // 开启后会强制对JS文件做类型检查，提升识别准确率
    },
    "include": ["**/*.js"],
    "exclude": ["node_modules"]
  }
  

• 动态语法干扰：代码中使用eval、with、动态属性赋值obj[varName] = xxx这类只能在运行时确定结构的语法时，静态分析工具无法提前感知属性的存在，也会导致识别失效。
  适配方案：尽量避免使用上述强动态语法，必须使用时补充JSDoc类型标注即可。
• 模块导出方式不规范：如果something所在的模块使用了动态导出逻辑（如module.exports[varName] = xxx），而非显式的export const something = xxx语法，语言服务无法识别导出内容，也会出现跳转失效。
  适配方案：优先使用ESModule的显式导出语法，CommonJS模块也尽量使用module.exports = { something }的静态导出写法。
• 扩展冲突：第三方JS语法扩展、格式化扩展可能会和内置的TypeScript语言服务冲突，导致语义分析异常。
  适配方案：尝试禁用所有非官方JS相关扩展后重启VS Code，排查是否为插件冲突导致。

你提到的示例对比可参考下方截图：

内容的提问来源于stack exchange，提问作者Michael G