TypeScript嵌套对象访问与属性修改报错问题求助

为什么直接访问嵌套属性报错？ #

当函数返回类型是object | null时，TypeScript仅知道返回值是一个对象，但无法确定对象的具体属性结构。直接访问some_obj.property_one.address时，TS无法验证property_one和address是否存在于该对象上，因此抛出“Property 'key' does not exist on type 'object'”的错误。

为什么{[key:string]: unknown}只能访问第一层属性？ #

{[key:string]: unknown}是索引签名类型，允许通过字符串键访问第一层属性，但第一层属性的类型是unknown。TypeScript对unknown类型做了严格的安全限制：在未明确类型的情况下，不允许对unknown值执行任何操作（包括访问子属性）。因为unknown可能是字符串、数字等基本类型，直接访问子属性会有运行时风险，所以TS会阻止这种操作。

1. 类型断言（快速实现，需确保数据结构符合预期） #

直接通过类型断言将对象指定为具体的结构类型，跳过TS的类型检查：

// 假设原函数返回类型为 object | null
const someObj = getTargetJson();

if (someObj !== null) {
  // 断言为包含目标属性的结构类型
  const typedObj = someObj as { property_one: { address: string } };
  typedObj.property_one.address = '*this is private*';
}

如果不确定结构，也可以逐层断言并做类型检查：

if (someObj !== null) {
  const propertyOne = (someObj as { property_one: unknown }).property_one;
  // 先确认property_one是对象类型
  if (typeof propertyOne === 'object' && propertyOne !== null) {
    (propertyOne as { address: string }).address = '*this is private*';
  }
}

2. 定义接口类型（规范且可复用） #

先定义匹配数据结构的接口，再将返回值断言为该接口类型，适合重复使用的场景：

// 定义对应的数据结构接口
interface TargetData {
  property_one: {
    address: string;
    // 可添加其他需要的属性
  };
}

const someObj = getTargetJson() as TargetData | null;

if (someObj !== null) {
  someObj.property_one.address = '*this is private*';
}

3. 类型守卫（安全可靠，适合不确定数据结构的场景） #

编写类型守卫函数，在运行时验证数据结构，让TS自动收窄类型：

interface TargetData {
  property_one: {
    address: string;
  };
}

// 类型守卫函数，验证对象是否符合TargetData结构
function isTargetData(obj: unknown): obj is TargetData {
  return (
    typeof obj === 'object' &&
    obj !== null &&
    'property_one' in obj &&
    typeof (obj as TargetData).property_one === 'object' &&
    (obj as TargetData).property_one !== null &&
    'address' in (obj as TargetData).property_one &&
    typeof (obj as TargetData).property_one.address === 'string'
  );
}

const someObj = getTargetJson();

if (isTargetData(someObj)) {
  // 此时TS已确认someObj符合TargetData类型，可安全访问属性
  someObj.property_one.address = '*this is private*';
}

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