Google Charts使用Column数组配置tooltip列时出现p属性类型报错

问题场景 #

尝试通过Column数组直接定义列配置，实现带HTML自定义能力的tooltip列，编写代码如下：

this.columnNames: Column[] = ['name', 'value',  {type: 'string', role: 'tooltip', p: {'html': true}}]

代码编写完成后触发编译报错，报错信息如下：

Type '{ type: string; role: string; p: { html: true; }; }' is not assignable to type 'Column'.   Object literal may only specify known properties, and 'p' does not exist in type 'ColumnSpec'.

核对官方文档说明，相同配置通过dataTable.addColumn({'type': 'string', 'role': 'tooltip', 'p': {'html': true}})方式调用可正常运行，两种写法的唯一差异是当前未实例化DataTable调用addColumn方法，而是直接用Column数组传配置。

报错根因 #

该报错不属于写法错误，本质是项目依赖的Google Charts TypeScript类型定义存在缺漏：ColumnSpec接口未声明运行时实际支持的p属性，导致TS静态检查阶段误判传入的对象属性非法。
addColumn方法的入参类型定义已经提前补充了p字段的类型声明，因此官方示例写法不会触发同类编译错误。

可行解决方案 #

• 类型断言快速修复：直接给配置对象加类型断言绕开多余的类型检查，不影响实际运行效果

  this.columnNames: Column[] = [
    'name',
    'value',
    {type: 'string', role: 'tooltip', p: {'html': true}} as Column
  ]
  

• 补全本地类型声明：在项目全局类型文件（通常命名为global.d.ts）中补充缺失的p属性定义，一劳永逸解决同类类型问题，同时保留TS类型提示能力

  declare global {
    namespace google.visualization {
      interface ColumnSpec {
        p?: Record<string, any>;
      }
    }
  }
  

• 对齐官方示例写法：放弃直接传Column数组的方式，改用DataTable.addColumn()方法逐列添加配置，适配现有类型定义。

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