如何让VS Code了解JSDOC跨多个文件的@typedef

Question

我想在一个文件中指定一个类型，并且能够在另一个文件中重用它。我试过modules但它在VS Code中不起作用。还有其他解决方案吗？我想让我的项目的所有类型都可以重用，这样我就可以跨文件在不同的函数中引用它们。 This is the closest question我找到了。

Answer 1

Since TypeScript 2.9（嵌入在较新的VS代码中），可以通过使用JSDoc中的import语法来实现，就像这样

/**
 * @typedef {import("koa").Context} Context
 *
 * @typedef {Object} BodyparserOptions
 * @prop {(ctx: Context) => boolean} [detectJSON] Custom json request detect function. Default `null`.
 */

此外，VS Code应该能够拾取整个工作空间中定义的所有类型。

Answer 2

在Visual Studio Code 1.33.1的普通JavaScript项目中使用jsconfig.json及其include属性取得了一些成功

{
  "include": [
    "src/**/*.js"
  ]
}

给出以下JavaScript项目：

src/
├── types/
|   ├── person.js
|   ├── question.js
|
├── answer.js
├── jsconfig.json

其中question.js和person.js都是类型定义：

person.js

/**
 * @typedef {object} Person
 * @property {string} firstName
 * @property {string} lastName
 */

question.js

/**
 * @typedef {object} Question
 * @property {Person} askedBy
 * @property {string} text
 */

answer.js是一个接受问题并返回答案的函数：

/**
 * Takes a question and return an answer
 * @param {Question} question 
 */
function answer(question) {
  return 42;
}

正如您在第一个截屏中看到的那样，当悬停在Question类型表示法上时，我确实获得了IntelliSense支持：

最重要的是，IntelliSense现在还能够根据我的类型定义提供代码完成：