�鸿蒙报错速查：arkts-strict-typing 函数返回值类型必须显式，忘标就炸，根因 + 真解法

报错原文

ERROR: 10505001 ArkTS Compiler Error
Error Message: arkts-strict-typing. At File: xxx.ets:N:N

报错触发场景

你写鸿蒙 ArkTS 函数时，忘标返回值类型就炸：

// ❌ 报错写法
greet(name: string) {
  return `Hello, ${name}`
}

add(a: number, b: number) {
  return a + b
}

async fetchName() {
  return 'Alice'
}

根因

鸿蒙 ArkTS 是强类型语言，函数返回值必须显式标类型------不能让编译器猜。这是跟前端 JS/TS 最大的差异：JS 里函数返回值类型可选，ArkTS 里必填。

ArkTS 这么设计的原因：编译期消除一切歧义，避免运行时因类型猜错产生的 bug。代价是写起来啰嗦，但运行更安全。

真解法

每个函数显式标返回值类型：

// ✅ 正解：显式返回类型 string
greet(name: string): string {
  return `Hello, ${name}`
}

// ✅ 正解：显式返回类型 number
add(a: number, b: number): number {
  return a + b
}

// ✅ 正解：显式返回类型 Promise<string>
async fetchName(): Promise<string> {
  return 'Alice'
}

真机配图：显式类型正解能编译能跑

函数显式标返回值类型------正解，能编译能跑。三个函数分别返 string/number/Promise：

显式类型正解初始态（greet/add/fetchName 均未调用）：

点调 greet + add + fetchName 后（greet=Hello, 鸿蒙 / add=8 / fetchName=Alice）：

报错写法（忘标返回类型）编译就炸，装不上真机；正解写法（显式标类型）能跑，三个函数都返了正确类型值。忘标就炸，标了就跑------这是 ArkTS 强类型最直白的证据。

高频踩坑场景

场景 1：回调函数忘标返回类型

// ❌ 报错（回调忘标）
arr.map((x) => { return x * 2 })

// ✅ 正解（回调标 number）
arr.map((x): number => { return x * 2 })

场景 2：Promise 忘标返回类型

// ❌ 报错
async fetchData() {
  return await http.send(...)
}

// ✅ 正解（标 Promise<string>）
async fetchData(): Promise<string> {
  return await http.send(...)
}

场景 3：箭头函数赋给变量忘标

// ❌ 报错
const fn = (x: number) => { return x * 2 }

// ✅ 正解（变量标类型 + 函数标返回类型）
const fn: (x: number) => number = (x: number): number => { return x * 2 }

场景 4：void 返回也要标

// ❌ 报错（onClick 回调忘标）
.onClick(() => { console.log('hi') })

// ✅ 正解（标 void）
.onClick((): void => { console.log('hi') })

一句话速查

arkts-strict-typing → 函数忘标返回类型，加 : 返回类型

跟前端 JS/TS 的差异

写法	JS/TS	ArkTS
fn(): string	✅	✅
fn()	✅ 默认 any	❌ 报错
async fn(): Promise<string>	✅	✅
async fn()	✅	❌ 报错

前端转鸿蒙最容易踩这个坑------肌肉记忆写 fn() { return ... }，ArkTS 直接编译炸。新项目从一开始就养成「函数必标返回类型」的习惯，避坑。

完整代码仓库

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

🔗 仓库地址 ：atomgit.com/JaneConan/a...

仓库包含：

• 四种高频踩坑场景的 ❌ 报错写法 + ✅ 正解写法对照
• string/number/Promise/void 四种返回类型示范
• 可直接用 DevEco Studio 打开参考

---

作者：JaneConan 仓库：atomgit.com/JaneConan/a... 协议：Apache-2.0，随便用，别告我