利用 i2c 快速从 Interface 生成 Class

利用 i2c 快速从 Interface 生成 Class（支持 TS & ArkTS）

在日常 TypeScript 或 ArkTS 开发中，需要根据 interface 定义手动实现对应的 class，这既重复又容易出错。分享一个命令行工具 —— interface2class，简称 i2c，可以自动完成class生产。

🔧 工具简介

• 名称：interface2class（i2c）
• 作用：根据 .ts 或 .ets 文件中的 interface 自动生成对应的 class 实现
• 适用语言：TypeScript、ArkTS
• 项目地址：https://github.com/HarmonyOS-Next/interface2class

📦 安装方式

推荐使用全局安装：

npm install -g interface2class

⚙️ 使用示例

假设有一个 ArkTS 的接口文件 message.ets，内容如下：

export interface Message {
  id: number;
  title: string;
  content: string;
  send(): void;
}

运行以下命令：

i2c ./message.ets

即可自动生成一个 message.ts 文件，内容如下：

export class MessageImpl implements Message {
  id: number;
  title: string;
  content: string;

  constructor() {
    this.id = 0;
    this.title = '';
    this.content = '';
  }

  send(): void {
    throw new Error("Method not implemented.");
  }
}

非常适合快速搭建原型、数据模型、Mock 类等。

❗ 遇到的问题：EPERM 权限错误

在安装时，我遇到了如下报错：

npm ERR! code EPERM
npm ERR! syscall mkdir
npm ERR! path D:\chang\dev_tools\DevEco Studio\tools\node\node_modules\interface2class
npm ERR! errno -4048
npm ERR! Error: EPERM: operation not permitted, mkdir ...

🛠️ 原因分析

这是 Windows 系统下常见的 权限不足 问题，主要原因可能包括：

• DevEco Studio 自带 Node 环境为受限目录，无法写入
• 当前终端未以管理员权限运行
• 系统安全软件（如杀毒软件）拦截

✅ 解决方法

采用了以下方案成功解决：

将 DevEco Studio 安装目录中 node_modules 设置为“可修改”权限。

或者也可以选择：

• 右键 PowerShell / CMD → 以管理员身份运行

• 或者使用自己系统安装的 Node（非 DevEco 内置），例如：

  npm install -g interface2class
  

📝 总结

如果你也在做多模型 ArkTS 项目，或正在用 HarmonyOS 的 DevEco Studio，不妨尝试这个工具。

附上命令验证小技巧：

i2c -v   # 查看版本号
i2c      # 查看帮助信息