VS Code中JS项目如何配置全局TypeScript定义实现智能提示？

我之前也碰到过一模一样的问题！给你几个排查和解决的方向，亲测有效：

如果你的项目还没有tsconfig.json，一定要新建一个，这是VS Code识别JS文件类型提示的核心配置：

{
  "compilerOptions": {
    "module": "NodeNext",
    "target": "ES2020",
    "allowJs": true, // 关键：允许TypeScript处理JS文件
    "checkJs": true, // 可选，开启后会提供更严格的类型校验和提示
    "noEmit": true // Node.js项目不需要生成TS编译产物，设为true即可
  },
  "include": [
    "**/*.js",
    "**/*.d.ts" // 确保包含你的自定义类型文件
  ]
}

如果你的.d.ts文件在特定子目录（比如types/），也可以把路径写得更明确："types/**/*.d.ts"

网上说的/// <reference path="..." />没错，但很多时候问题出在路径写错！举个例子：

• 你的JS文件在src/index.js
• 自定义类型文件在src/types/definition.d.ts
  那正确的引用应该是：

/// <reference path="./types/definition.d.ts" />

写完后可以试试重启VS Code窗口，有时候语言服务需要刷新才能识别新的引用。

自定义类型的暴露方式决定了你怎么在JSDoc里引用：

1. 全局类型（不需要import） #

如果想让类型在所有JS文件里直接可用，要把类型放在declare global块里，并且最后加export {}让TS识别为模块：

declare global {
  interface TypeDefinedInExternalFile {
    name: string;
    value: number;
  }
}

export {}; // 这行不能少！

之后在JS里就能直接用：

/// <reference path="./types/definition.d.ts" />
/** @type {TypeDefinedInExternalFile} */
let x = someValue;

2. 模块类型（需要通过import引用） #

如果你的.d.ts是模块式的（比如用export导出类型）：

export interface TypeDefinedInExternalFile {
  name: string;
  value: number;
}

那JSDoc里要改用TS的模块引用语法：

/// <reference path="./types/definition.d.ts" />
/** @type {import('./types/definition').TypeDefinedInExternalFile} */
let x = someValue;

如果配置都对但还是没提示，可以试试：

• 按Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac），输入TypeScript: Restart TS Server，重启语言服务
• 检查VS Code设置里的javascript.implicitProjectConfig.checkJs是否设为true，这个选项会自动给JS文件启用类型检查

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