在 vscode 中解析 jsdoc/tsdoc

Question

我有这个接口属性:

  /**
   * If enabled the log output will be printed locally in console.
   * The log call line will not be overwritten unless {@link ILoggerConfig.useLoggerProcessors} is true
   */
  printToConsole?: boolean;

在生成的文档中，它使 ILoggerConfig.useLoggerProcessors 成为可点击的 link 但 vscode intellisense 不会：

link 部分不会打扰我，但 vscode intellisense 保留冗长的 {@link ILoggerConfig.useLoggerProcessors} 部分，当引用超过 2 个其他 properties/classes/methods 时，很难阅读.

我可以让 vscode 解析评论吗？我搜索了 tsdoc extension 但找到了 none.

Answer 1

这是 VS Code 1.31 的错误。以下问题正在跟踪它：

• https://github.com/Microsoft/TypeScript/issues/16498
• https://github.com/Microsoft/TypeScript/issues/29617

已经支持 JSDocs 中的 Markdown 链接（但仅限于 url，不支持符号）。