我怎样才能拥有类似于@deprecated注释的东西？

Question

我有一个 TypeScript Next.js 应用程序，我在编码时使用 VSC。

我喜欢这个功能：如果我在函数上方添加

@deprecated

的 JSDoc 注释，那么该函数的所有用法都会将函数名称删除作为视觉警告：

我常常想将函数标记为

@deprecated

，只是为了确保每当有人尝试使用它们时，他们都会格外密切注意并阅读注释。

但是当我没有计划终止该功能时，我不想使用“已弃用”这个词。

例如，有时我只是想引起注意说：“你几乎肯定应该调用[这个其他函数]，而不是调用这个函数。”

还有其他可用的注释吗？如果没有，我该如何创建一个？

我希望所有用法都能自动更改函数名称的外观（使用删除线或其他样式）。

Answer 1

可能有这样的功能，但我没有意识到，而且我更有信心没有这样的功能。弃用主要是一种“硬编码”状态类型。请自行查看 VS Code 的扩展 API 文档。同样的情况也适用于语义突出显示中的弃用修饰符。

但说到语法高亮，VS Code 中的语义高亮和基于 TextMate 的语法高亮都支持

fontStyle

修改中的删除线、斜体、粗体和下划线。因此，您可以编写一个 VS Code 扩展，为您的函数提供 TextMate 或语义突出显示范围，然后为其定义字体样式。听起来有点过分，但应该是可能的。