VSCode IntelliSense解析含const char[]的函数注释时出现合并异常

一、VSCode IntelliSense注释解析问题的解决配置 #

针对[]导致注释解析混乱、注释错误合并的问题，可通过以下配置调整修复：

• 匹配MSVC 2019环境配置
  在.vscode/c_cpp_properties.json中确保配置与你的MSVC环境一致，示例如下：

  {
      "configurations": [
          {
              "name": "Win32",
              "compilerPath": "C:/Program Files (x86)/Microsoft Visual Studio/2019/Community/VC/Tools/MSVC/14.29.30133/bin/Hostx64/x64/cl.exe",
              "cStandard": "c11",
              "cppStandard": "c++17",
              "intelliSenseMode": "windows-msvc-x64",
              "includePath": ["${workspaceFolder}/**"]
          }
      ],
      "version": 4
  }
  

  注意替换compilerPath为你本地MSVC的实际安装路径。
• 切换IntelliSense引擎
  在VSCode设置中搜索C_Cpp.intelliSenseEngine，将值改为Default——默认的Tag Parser引擎对复杂语法的注释支持较弱，全量解析的Default引擎更适配MSVC语法规则。
• 重置IntelliSense缓存
  按Ctrl+Shift+P调出命令面板，执行C/C++: Reset IntelliSense Database，之后重启VSCode重新加载项目。
• 排查第三方扩展干扰
  暂时禁用所有非官方的C/C++相关扩展，确认是否是扩展冲突导致的解析异常。

二、头文件中使用const char[]的规范性 #

const char[]作为函数参数在C/C++头文件中完全符合规范：

• 语法层面：C和C++标准均允许这种写法，函数参数中的const char[]会自动退化为const char*，语义上与指针写法等价，但能更直观地表达参数预期是字符数组的设计意图，提升代码可读性。
• 实践层面：众多开源项目和工业级代码都会采用这种写法明确参数的数组属性，不存在规范问题。
• 场景区分：如果是定义全局/局部数组变量，const char arr[] = "test"与const char* arr = "test"存在本质差异（前者是数组实例，后者是指向字符串常量的指针），但作为函数参数时两者无功能区别。

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