报错原文
vbnet
ERROR: 10505001 ArkTS Compiler Error
Error Message: Cannot find name 'require'. Did you mean 'Require'? At File: xxx.ets:N:N报错触发场景
你写鸿蒙 ArkTS 时，用 Node.js 的 require() 就炸：
typescript
// ❌ 报错写法
const path = require('path')
const fs = require('fs')
const http = require('@ohos.net.http')根因
鸿蒙 ArkTS 禁用 Node.js 的 require() ------这是跟 Node.js 最大的差异。Node.js 里 require() 是 CommonJS 规范的模块加载，ArkTS 按 ES Module 规范设计只能用 import。
ArkTS 这么设计的原因：ES Module 是静态分析友好的 ------import 在编译期就能解析依赖图，require() 是运行时动态加载编译器分析不了。ArkTS 要求编译期消除一切歧义，禁用 require()。
真解法
用 import 替代 require()，三种姿势：
解法 1：import 整个模块
typescript
// ✅ 正解 1：import 整个模块替代 require()
import common from '@ohos.app.ability.common'
import relationalStore from '@ohos.data.relationalStore'
// 用法
const ctx: common.UIAbilityContext = getContext(this) as common.UIAbilityContext
const rdb: relationalStore.RdbStore = await relationalStore.getRdbStore(ctx, config)解法 2：import { } 解构单个符号
typescript
// ✅ 正解 2：import { } 解构替代 require()
import { AppStorageV2 } from '@ohos.arkui.StateManagement'
import { BusinessError } from '@ohos.base'
// 用法
const cfg = AppStorageV2.connect(AppConfig, 'appConfig', () => new AppConfig())解法 3：import type 仅类型引入
typescript
// ✅ 正解 3：import type 仅类型引入替代 require()
import type { Want } from '@ohos.app.ability.Want'
// 用法（仅类型注解，不占运行时）
const want: Want = { bundleName: 'com.xx', abilityName: 'Main' } as Want真机配图：import 替代 require 正解能编译能跑
import / import { } / import type 三种替代 require()------正解，能编译能跑。三个函数都真返了正确类型值：
import 正解初始态（import common/import relationalStore/import type Want 均未调用）：
点调三个函数后（import common=common.UIAbilityContext，import relationalStore=relationalStore.RdbStore，import type Want=Want.type）：
报错写法（用
require()）编译就炸，装不上真机；正解写法（import/import { }/import type替代）能跑，三种替代都真返了正确类型值。用了 require 就炸，import 就跑------这是 ArkTS ES Module 规范最直白的证据。
高频踩坑场景
场景 1：Node.js 习惯写 require('path')
typescript
// ❌ 报错（Node.js 习惯）
const path = require('path')
const joined = path.join('a', 'b')
// ✅ 正解（鸿蒙沙箱内不用 path.join，用字符串拼接或 ohos.file.fs）
const joined = 'a' + '/' + 'b'场景 2：动态加载 require(variable)
typescript
// ❌ 报错（require 不能动态加载）
const mod = require动态名
// ✅ 正解（import 静态加载所有可能的模块）
import modA from './modA'
import modB from './modB'
const mod = condition ? modA : modB场景 3：require 拿 Node.js 内置模块
typescript
// ❌ 报错（Node.js 内置模块鸿蒙没有）
const fs = require('fs')
const http = require('http')
// ✅ 正解（鸿蒙对应模块用 import）
import fs from '@ohos.file.fs'
import http from '@ohos.net.http'场景 4：require 拿相对路径模块
typescript
// ❌ 报错
const utils = require('./utils')
// ✅ 正解（import 相对路径）
import { helper } from './utils'一句话速查
Cannot find name 'require' → 禁用 require()，用
import/import { }/import type替代
跟 Node.js 的差异
| 写法 | Node.js | ArkTS |
|---|---|---|
const x = require('mod') |
✅ CommonJS | ❌ 报错 |
import x from 'mod' |
✅ ESM | ✅ |
import { x } from 'mod' |
✅ ESM | ✅ |
import type { T } from 'mod' |
✅ ESM | ✅ |
require(变量) 动态加载 |
✅ | ❌ 报错 |
Node.js 转鸿蒙最容易踩这个坑------肌肉记忆写 require()，ArkTS 直接编译炸。新项目从一开始就养成「禁用 require，只用 import」的习惯，避坑。
require 三种替代速查表
| 替代方案 | 适用场景 | 写法示例 |
|---|---|---|
import 整模块 |
拿整个模块 | import http from '@ohos.net.http' |
import { } 解构 |
拿单个符号 | import { AppStorageV2 } from '@ohos.arkui.StateManagement' |
import type |
仅类型注解 | import type { Want } from '@ohos.app.ability.Want' |
铁律 ：ArkTS 里搜不到 require 关键字------遇到「要拿模块」就 import / import { } / import type，别想 require()。
完整代码仓库
本文所有正解写法都已托管到 AtomGit：
🔗 仓库地址 ：atomgit.com/JaneConan/a...
仓库包含：
- 四种高频踩坑场景的 ❌ 报错写法 + ✅ 正解写法对照
import/import { }/import type三种替代方案示范- 可直接用 DevEco Studio 打开参考
作者：JaneConan 仓库：atomgit.com/JaneConan/a... 协议：Apache-2.0，随便用，别告我