如何在VS Code中获取类似CLion的详尽函数描述？

效果对比 #

VS Code 原生IntelliSense提示 #

IntelliJ（CLion同系列）的提示 #

VS Code自带的IntelliSense提示描述通常较为简短，想要获得类似CLion的详尽提示效果，可以通过以下方式实现：

• 安装对应语言的增强插件：
  不同语言有针对性的增强插件，比如C/C++开发可选用Clangd插件——它基于LLVM，和CLion使用同源的代码分析引擎，能提供完整的函数文档、参数说明、类型信息甚至示例代码；Python开发推荐Pylance插件，默认就会解析并展示完整的函数docstring、参数类型与返回值说明。
• 调整插件配置提升提示细节：
  多数增强插件支持自定义提示详细度，比如在VS Code设置中：
  • 针对Clangd，可开启clangd.completion.detailLevel为full，并启用clangd.completion.enableSnippets来显示代码片段提示；
  • 针对Pylance，可将Python > Analysis: Type Checking Mode设为basic或strict，同时开启Python > Analysis: Show Docstrings以展示完整文档内容。
• 完善项目代码的文档注释：
  插件的详尽提示依赖规范的代码注释，比如C++使用Doxygen风格注释、Python使用Google/Numpy风格docstring，规范的注释会被插件识别并在提示中完整展示，让提示内容更丰富。

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