报错原文

ERROR: 10505001 ArkTS Compiler Error
Error Message: Property '__proto__' does not exist on type 'Object'. At File: xxx.ets:N:N

常伴生报错：

Error Message: Usage of standard library is restricted (arkts-limited-stdlib)

报错触发场景

你写鸿蒙 ArkTS 时，访问 __proto__ 或改原型链就炸：

// ❌ 报错写法
class Animal { name: string = 'animal' }
class Dog extends Animal { breed: string = 'dog' }

const d: Dog = new Dog()
const proto: object = (d as Object).__proto__         ← Property '__proto__' does not exist
Object.setPrototypeOf(d, null)                         ← arkts-limited-stdlib
const p: object | null = Object.getPrototypeOf(d)      ← arkts-limited-stdlib

根因

鸿蒙 ArkTS 禁用 __proto__ 原型链访问 + 限制 Object 标准库——这是跟前端 JS 最大的差异。JS 里 obj.__proto__ 是直访原型链逃生阀，ArkTS 里 Object 类型不含 __proto__ 属性直接报错。

ArkTS 这么设计的原因：原型链访问破坏类型继承契约——Dog extends Animal 编译期继承关系明确，运行时 __proto__ 动改原型链让编译器分析不了。ArkTS 要求编译期消除一切歧义，禁用 __proto__ 保持继承关系稳定。

真解法

用 class 继承 + super 替代原型链操作：

解法 1：class extends 显式继承替代 proto

// ✅ 正解 1：class extends 显式继承替代原型链
class Animal {
  name: string = 'animal'
  speak(): string { return `${this.name} makes a sound` }
}

class Dog extends Animal {
  breed: string = 'dog'
  bark(): string { return `${this.name} (${this.breed}) barks` }
}

const d: Dog = new Dog()
const s: string = d.speak()      ← 继承自 Animal，编译期已知
const b: string = d.bark()       ← Dog 自己的

解法 2：interface 组合替代原型链混入

// ✅ 正解 2：interface 组合替代原型链混入
interface Walker { walk(): string }
interface Swimmer { swim(): string }

class Duck implements Walker, Swimmer {
  walk(): string { return 'duck walks' }
  swim(): string { return 'duck swims' }
}

解法 3：class 继承链替代原型链查询

// ✅ 正解 3：class 继承链替代原型链查询
class Base { baseMethod(): string { return 'base' } }
class Mid extends Base { midMethod(): string { return 'mid' } }
class Leaf extends Mid { leafMethod(): string { return 'leaf' } }

const l: Leaf = new Leaf()
// 不用 __proto__ 查继承链，直接 instanceof 判断
const isBase: boolean = l instanceof Base    ← true
const isMid: boolean = l instanceof Mid      ← true
const isLeaf: boolean = l instanceof Leaf    ← true

高频踩坑场景

场景 1：查原型链

// ❌ 报错
const proto = d.__proto__
const proto2 = Object.getPrototypeOf(d)

// ✅ 正解（instanceof 判断继承关系）
const isDog: boolean = d instanceof Dog
const isAnimal: boolean = d instanceof Animal

场景 2：改原型链混入

// ❌ 报错
Object.setPrototypeOf(d, mixinProto)
d.__proto__ = mixinProto

// ✅ 正解（interface implements 组合）
class Dog extends Animal implements Walker, Swimmer {
  walk(): string { return 'dog walks' }
  swim(): string { return 'dog swims' }
}

场景 3：原型链继承多级

// ❌ 报错
const proto = obj.__proto__.__proto__.__proto__

// ✅ 正解（class 继承链 + instanceof）
class A {}
class B extends A {}
class C extends B {}
const c: C = new C()
const isA: boolean = c instanceof A    ← true，编译期已知

场景 4：动态判断对象类型

// ❌ 报错
const typeName = obj.__proto__.constructor.name

// ✅ 正解（instanceof 或 constructor）
class Dog { breed: string = 'dog' }
const d: Dog = new Dog()
const isDog: boolean = d instanceof Dog
const ctor: Dog = d.constructor as Dog

一句话速查

Property ‘proto’ does not exist + arkts-limited-stdlib → 禁用 proto 和 Object 标准库，用 class extends / interface implements / instanceof 替代

跟前端 JS 的差异

写法	JS	ArkTS
obj.__proto__	✅	❌ 报错
Object.getPrototypeOf(obj)	✅	❌ arkts-limited-stdlib
Object.setPrototypeOf(obj, p)	✅	❌ arkts-limited-stdlib
class A extends B	✅	✅
interface I implements J	✅	✅
obj instanceof Class	✅	✅

前端转鸿蒙最容易踩这个坑——JS 里 __proto__ 是原型链逃生阀，ArkTS 里直接编译炸。新项目从一开始就养成「禁用 proto 和 Object 标准库，用 class extends / instanceof」的习惯，避坑。

proto 替代速查表

替代方案	适用场景	写法示例
class extends	继承关系	class Dog extends Animal
interface implements	组混入	class Duck implements Walker, Swimmer
instanceof	判断继承	d instanceof Animal

铁律：ArkTS 里搜不到 __proto__——遇到「要查/改原型链」就 class extends / interface implements / instanceof，别想 proto。

完整代码仓库

本文所有正解写法都已托管到 AtomGit：

🔗 仓库地址：https://atomgit.com/JaneConan/arkui-bug-no-prototype

仓库包含：

• 四种高频踩坑场景的 ❌ 报错写法 + ✅ 正解写法对照
• class extends / interface implements / instanceof 三种替代方案示范
• 可直接用 DevEco Studio 打开参考

---

作者：JaneConan 仓库：https://atomgit.com/JaneConan/arkui-bug-no-prototype 协议：Apache-2.0，随便用，别告我