VSCode中Android NDK下std::vector同模板类型部分变量natvis不生效问题

出现该问题的核心原因主要有三类：

• 类型匹配优先级问题：你当前定义的是std::__ndk1::__vector_base基类的规则，若调试器内置/你额外配置了std::__ndk1::vector派生类的natvis规则，派生类规则优先级更高，会直接覆盖基类规则。而部分调试器的内置规则仅对单字节元素（比如unsigned char）的vector做了适配，多字节元素的规则存在缺陷，就会出现仅unsigned char类型生效的情况。
• 指针类型擦除问题：natvis解析时如果找不到足够的类型调试信息，会把非单字节元素的__begin_、__end_指针识别为void*或unsigned char*，此时指针减法的计算逻辑会出错，导致整个规则因表达式求值失败被跳过。而unsigned char类型的指针本身和擦除后的类型一致，所以不会出现求值错误。
• 调试信息裁剪：NDK默认编译选项会裁剪不常用类型的调试符号，unsigned long类型的vector的类型信息可能被裁剪，导致natvis规则匹配失败。

修复步骤 #

1. 优化natvis规则，同时覆盖派生类和基类，显式指定元素指针类型避免类型擦除：

<Type Name="std::__ndk1::vector&lt;*&gt;">
  <DisplayString>{{size={__end_ - __begin_}}}</DisplayString>
  <Expand>
    <Item Name="[size]" ExcludeView="simple">__end_ - __begin_</Item>
    <Item Name="[capacity]" ExcludeView="simple">__end_cap_.__value_ - __begin_</Item>
    <ArrayItems>
      <Size>__end_ - __begin_</Size>
      <ValuePointer>($T1*)__begin_</ValuePointer>
    </ArrayItems>
  </Expand>
</Type>
<Type Name="std::__ndk1::__vector_base&lt;*&gt;">
  <DisplayString>{{size={__end_ - __begin_}}}</DisplayString>
  <Expand>
    <Item Name="[size]" ExcludeView="simple">__end_ - __begin_</Item>
    <Item Name="[capacity]" ExcludeView="simple">__end_cap_.__value_ - __begin_</Item>
    <ArrayItems>
      <Size>__end_ - __begin_</Size>
      <ValuePointer>($T1*)__begin_</ValuePointer>
    </ArrayItems>
  </Expand>
</Type>

注：规则中的$T1对应容器的第一个模板参数，也就是元素类型，显式强转可以避免指针类型被擦除导致的求值错误。

2. 修改NDK编译参数，添加-g3 -fno-eliminate-unused-debug-types，强制保留所有调试类型信息，避免符号被裁剪。

3. 若仍不生效可以开启调试器的natvis诊断日志，直接查看规则匹配失败的具体原因，针对性调整。

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