起因

我平时的开发流程是两段:写代码在一个编辑器里,编译调试在 DevEco 里。来回切窗口切得烦,尤其是改一个 ArkTS 页面的小布局,也要切过去等它索引、等它编译,切回来接着改。

看到 CodeArts Agent 的时候我动了心思。它是华为自己出的 AI 编码 IDE,VS Code 的底子,界面和快捷键都不用重新学,官方还有鸿蒙相关的插件。如果它能覆盖"写"这一半,我就能在一个窗口里待很久。

于是我做了一个决定:一周内所有鸿蒙相关的编码工作,都在这一个 IDE 里做。构建和调试允许切走,但代码、阅读、重构尽量不出去。

结论先放在这里:它的确能当"笔",但当不了"手和腿"。 而且这次尝试让我对"AI 编码工具在鸿蒙生态里能干什么"有了比预期更清楚的认识。

先确认一件事:它到底是不是 VS Code

这个判断很重要,因为它决定了后面所有的期待。如果它是个"原生鸿蒙 IDE",那没有运行按钮就是缺陷;如果它是个"AI 编码前端",那没有运行按钮就是定位。

我翻了它的 product.json:

nameLong   = "CodeArts Agent"
version    = "26.11.100"
quality    = "stable"
extensionsGallery = {
  serviceUrl: "https://cloudide.cn-north-4.myhuaweicloud.com/v1/marketplace",
  openVSXServiceUrl: "https://open-vsx.org/vscode",
  ...
}

再看用户数据目录:User/workspaceStorage、extensions.json、argv.json、languagepacks.json——标准 VS Code 那一套,连 code.lock 都在。崩溃日志里的 Electron 版本是 39.3.0。

所以它是 VS Code 的深度定制发行版,扩展市场指向华为云 + Open VSX,自带 107 个扩展,其中华为自己的有 huaweicloud.authentication、huaweicloud.codearts-agent-support、huaweicloud.codearts-pay、huaweicloud.resource-explorer 这几个,主打的是"AI 编码 + 华为云资源"。

跟 Trae 属于同一类产品:编辑器内核是开源的,AI 和生态是自家的。

想清楚这一点之后,我的期待就调整了:它不是 DevEco 的替代品,它是 DevEco 的前置环节。

第一天:期待和现实

装好之后第一印象不错。界面是典型的 VS Code 骨架,左侧资源管理器、中间编辑器、右侧辅助面板。打开我那个真实项目,.ets 文件有语法高亮,配色和结构都正常,至少看起来是认识这个语言的。

然后我想跑起来看看。找运行按钮,没找到。

编辑器右上角是空的。我以为是自己没打开某个面板,按了 Cmd+Shift+D 切到"运行和调试",面板里只有一句提示:

打开文件,可调试或运行。
要自定义运行和调试,请创建一个 launch.json 文件。

在这里插入图片描述

这里我得诚实说一句:当时我的第一反应是"配置问题"。所有 VS Code 用户都形成了一种条件反射——没有按钮,那就是缺个 launch.json。我甚至在工程里翻了一圈,发现 .arts 目录里本该有一份配置,而它根本不存在。

排查:按钮是"被贡献"出来的

冷静下来之后我开始按 VS Code 的机制查。运行按钮这个东西,不是设置项,是扩展"贡献"出来的:

  • debuggers 贡献点决定"有没有调试器",这是 Run 菜单有内容的前提;
  • menus.editor/title/run 决定编辑器右上角那个按钮会不会出现;
  • launch.json 只是配置,type 必须有一个已注册的调试器去认领,否则就是一份死文件。

所以我该看的不是配置,是扩展清单。翻了一下 app 包内的 Contents/Resources/app/extensions,一共 107 个自带扩展,全是 git、python、java、cpp、dart、rust 这些通用语言包,加上几个 huaweicloud.* 的账号与资源类扩展。

没有一个跟 ohos、arkts、harmony 沾边。

事情到这里就清楚了:这个 IDE 不认识鸿蒙工程的"工程类型",它只知道 .ets 是一种文本文件。没有鸿蒙扩展,就没有调试器,就没有运行按钮——不是我没配置,是这个按钮在它的世界里不存在。

顺便说一个方法论:判断"某类项目能不能在某个 VS Code 系 IDE 里跑",最有效的办法是去扩展市场搜有没有对应的调试器,而不是翻设置。按钮灰着也好、消失也罢,根子都在贡献点。

装官方插件:能补上多少

华为确实在 Open VSX 上架了 VS Code 版插件,名字叫 HarmonyOS Dev Assistant for VS Code,发布者是 HuaweiDeveloperServicePlatform。我下了 darwin-arm64 的 VSIX,七十六兆,解开读 package.json。

先看它给了什么:

贡献点内容
languagesarkts(绑 .ets)、json5
grammarssource.arkts 语法定义
semanticTokenTypesstruct、component、label 等 ArkTS 专有语义
jsonValidation7 份 schema,覆盖 module.json5、build-profile.json5、oh-package.json5 等
viewsContainers一个 AI 助手面板
commands一堆 harmonybot.*,加一个 arkts.restartServer
configurationarkts.deveco.path、harmonybot.agentSettings 等

再看它没给什么:依然没有 debuggers,也没有 editor/title/run。

这个结果让我有点意外,但也在情理之中。它是个"AI 助手"插件,主打的是对话、补全、写代码,不是构建调试。所以指望装了它就有运行按钮,是想多了。

装的过程没什么好说的,一行命令:

"/Applications/CodeArts Agent.app/Contents/Resources/app/bin/code" \
  --install-extension ./hda.vsix --force

扩展视图里能直接看到它:

在这里插入图片描述

配路径:一个容易填错的字段

装完不等于能用。这个插件干的是"调用 DevEco 装在机器上的那套工具链",所以得告诉它 DevEco 在哪。

它有一个硬编码兜底 /Applications/DevEco-Studio.app,并从这个路径推导工具链:

<DevEco>/Contents/tools/hvigor/bin

所以 arkts.deveco.path 要填到 Contents 这一层,不是 .app:

{
  "arkts.deveco.path": "/Applications/DevEco-Studio.app/Contents",
  "harmonybot.agentSettings": {
    "devEcoStudio": { "installPath": "/Applications/DevEco-Studio.app/Contents" }
  }
}

在这里插入图片描述

我一开始填的是 .app,结果语言服务起不来。改回 Contents 之后正常——这种"路径精确到哪一层"的要求,文档里经常写得含糊,只能试。

顺带说一个判断依据:我机器上有两套 DevEco(26.0.0 和 6.1.1),到底用哪套?别按版本号猜,看工程里 .hvigor/cache/project-config.json 记的上次构建路径:

"sdkPath": "/Applications/DevEco-Studio.app/Contents/sdk"

跟着历史走,比猜靠谱。

语言服务确实起来了

配置对了之后,反应很直接。打开 .ets 文件,插件日志目录下出现了 server/idea-lsp-server.log,持续打印:

[INFO] - Sending request 'aceProject/onAsyncDidOpen'
[INFO] - callValidate: EntryAbility.ets
[TRACE] - synchronizeHostData: isProgramUptoDate cost: 0.1103ms

也就是说,DevEco 那套 ArkTS 语言服务(ace-server)已经被接管了。补全、跳转、诊断,用的都是官方引擎,不是插件自己实现的。

这一点很关键,也是我最后愿意继续用它的原因:它不是"假装懂 ArkTS",它是真的把 DevEco 的大脑接进来了。

不过它不稳。用了一周,状态栏出现过两次"LSP服务已停止"。停的时候补全直接失效,schema 校验也没了。扩展里注册了 arkts.restartServer 命令(命令面板里叫 ArkTS: Restart Language Server),用它重启比关掉整个 IDE 快得多。

我猜这跟登录态有关——AI 面板里一直提示"登录信息已经过期,请重新登录"。语言服务本身应该不需要账号,但插件的启动流程里可能掺了鉴权逻辑。这条我没法证实,只记录现象。

两个与代码无关的坑

这一周里最耗时间的两次问题,都跟鸿蒙没关系,纯粹是 macOS 的机制。

第一个是 App Translocation。 我把 app 放在 ~/Downloads 里直接双击启动,系统给它挂了个隔离标记,然后把它映射到一个随机命名的只读临时目录去运行:

/private/var/folders/…/T/AppTranslocation/53A658FA-…/d/CodeArts Agent-2.app

结果就是扩展的本地化包找不到、二进制 sidecar 定位不到,日志里刷一片 No bundle location found。我一开始以为是插件装坏了,重装了两遍,白费半小时。

正确做法是搬到 /Applications 再清隔离属性:

ditto "…/Downloads/CodeArts Agent-2.app" "/Applications/CodeArts Agent.app"
xattr -dr com.apple.quarantine "/Applications/CodeArts Agent.app"

第二个坑更隐蔽:~/Downloads 受 TCC 保护。 就算你给了完全磁盘访问权限,在那个目录里改文件扩展属性还是会失败:

xattr: [Errno 1] Operation not permitted: '…/Downloads/CodeArts Agent-2.app'

连 touch 一个空文件都不行。所以顺序必须是"先复制出去,再到新位置清标记",不能原地改。这一点没有任何提示,只能靠报错反推。

这两个坑跟鸿蒙无关,但如果你也在这台机器上配这套工具,大概率会撞上。撞上时的表现是"插件装了没反应",很容易往错误的方向排查。

它能干什么:比我预想的多

用了一周,真正让我留下的是这几件事。

第一,读工程。 我让它读一个别人的开源鸿蒙项目,问"这个工程有几个模块、面向哪些设备、用什么 SDK"。它翻 build-profile.json5、module.json5、oh-package.json5,两分钟给出了一份结构地图。自己看的话,这三个文件也得翻十分钟。

第二,改配置。 鸿蒙工程的配置文件层级多(app.json5 在应用级、module.json5 在模块级、build-profile.json5 在产品级),人很容易写错层级。有 schema 校验之后,写错立刻报红,不用等编译。这一点比我自己的手写速度快很多。

第三,跨文件改名。 把一个权限常量从旧名字改到新名字,涉及七八个文件。这种事人做容易漏,AI 做得很稳。

第四,写样板。 一个页面的骨架、一个 Ability 的空实现,让它生成比我自己敲快。生成的代码我一般会再调,但从零写和"改一份差不多的",心理成本差很多。

schema 校验这件事,比想象中值钱

官方插件里我最看重的一项不是补全,是那 7 份 JSON schema。它覆盖的文件是:

module.json5          → 模块清单:ability、deviceTypes、permissions
build-profile.json5   → 产品配置:SDK 版本、签名、构建模式
oh-package.json5      → 依赖与包信息
main_pages.json       → 页面路由表
app.json5             → 应用级:包名、版本、图标
resources element/*   → 资源元素(字符串、颜色、尺寸)
hvigor-config.json5   → 构建工具配置

这东西的价值在于"层级"。鸿蒙的配置分散在应用级、模块级、产品级三层,字段名又长得像,写错层级不一定会立刻报错,但行为会变得莫名其妙——比如你把权限声明写到 AppScope/app.json5 里,编译可能过得去,运行时就是拿不到权限。

有 schema 之后,至少字段名和取值能被立刻拦住。举个我确认过的例子:module.json5 的 deviceTypes 只能取 phone、tablet、2in1、wearable 这几个值,写个 mobile 上去,编辑器立刻标红,不用等构建。

这件事跟我前两天白屏的经历是同一类问题:鸿蒙的错误经常不在代码里,在配置里。 而配置类错误最烦的地方是它不报错、只表现异常。有 schema 兜底,等于把一部分运行时问题提前到了敲键盘的时候。

它的慢,慢在哪里

用了一周,卡顿的地方和我想的不一样。

不是打字卡。编辑器本身很跟手,.ets 文件几百行也不掉帧。

慢在第一下。打开一个大工程,语言服务要起 ace-server、要建索引,头十几秒补全会是空的。日志里能看到它在慢慢处理:

[INFO] - Sending request 'aceProject/onAsyncDidOpen'
[TRACE] - synchronizeHostData: isProgramUptoDate cost: 0.110ms

单次请求很快(零点几毫秒),但打开文件时会批量发起,工程越大越明显。这个体验跟 DevEco 首屏索引是一个道理,只不过 DevEco 索引一次就一直在,这里要依赖扩展宿主的存活。

扩展宿主是真的会重启。我翻日志看到过好几次:

[info] Extension host with pid 72366 exiting with code 0
[info] Extension host with pid 72370 exiting with code 0

退出码是 0,说明不是崩溃,是被主动重启了。每次重启,语言服务就得重新起,补全要等一会儿才回来。

另一个反复出现的是登录态。AI 面板右上角一直挂着一条:

登录信息已经过期,请重新登录

这条提示不影响写代码,但影响那个 AI 面板。我一周里没成功用上它——这是我没有账号的问题,不是产品的问题,但得说明白:如果你指望用它的 AI 对话来写代码,先准备好华为账号。

它不能干什么:一条清晰的线

反过来,这一周里所有失败的尝试,都指向同一件事——它碰不到设备。

编译它其实能做,因为构建就是跑命令。但它默认不敢做:工程没受信任时任务被禁用,我配了 .vscode/tasks.json 按 Ctrl+Shift+B 也没反应。信任之后能跑,但也就到"生成 HAP"为止。

再往后就不行了:签名要账号、装包要设备、启动要看日志。这三步它都不能独立完成。

所以边界很干脆:不需要设备也不要签名的活儿,它都能接;一旦要落到设备上,就必须切走。

我试过让它的 AI 面板直接做这件事(那个面板里有一堆 skill,包括模拟器调试闭环、devecocli 工作流),但面板一直卡在"登录信息已过期"。没有账号,这条路我走不通。这是它的设计前提,不是 bug。

还有一条路:官方 CLI

写这篇的时候我发现一个新东西。DevEco 里在推一个叫 DevEco Code 的迁移提示,里面写着:

npm install -g @deveco/deveco-code

我查了 npm,这个包是真实存在的,当前 latest 是 0.2.5,装完命令叫 devecocli,子命令是:

build      构建 HarmonyOS 工程
run        在已连接的设备上构建并运行
emulator   管理模拟器实例
login      登录华为开发者账号
logout     退出登录
update     升级 deveco-cli

有意思的是 login 和 emulator 排在 run 前面——这个顺序本身就说明了依赖关系:想跑,先登录,先有设备。

这件事对"AI IDE 能不能替 DevEco"这个问题有影响,但影响有限。它解决的是"运行能不能脱离 GUI",不是"运行能不能脱离签名和设备"。在 CodeArts Agent 的终端里敲 devecocli run,理论上也能跑,但你依然要有一个登录过的账号和一台连上的设备。

我没在这台机器上装它——因为我现在有 DevEco 的图形界面,hdc 也够用,再装一套 CLI 只是多一个变量。但如果你在纯命令行环境(比如 CI 或者远程开发),这条路就是唯一的路。

顺带说说插件从哪来

这个 IDE 的扩展市场是华为云那套(marketplace.ide.huaweicloud.com),另外挂了一个 Open VSX 作为补充源。官方那个鸿蒙插件就是 Open VSX 上的,HuaweiDeveloperServicePlatform 命名空间下。

如果你在不能直连的环境里,也可以下 VSIX 手动装:

# 按平台下载(这次是 darwin-arm64)
curl -L -o hda.vsix \
  "https://open-vsx.org/api/HuaweiDeveloperServicePlatform/harmonyosdevassistantforvscode/darwin-arm64/0.2.4/file/HuaweiDeveloperServicePlatform.harmonyosdevassistantforvscode-0.2.4@darwin-arm64.vsix"

# 用 IDE 自带的 CLI 装
"/Applications/CodeArts Agent.app/Contents/Resources/app/bin/code" \
  --install-extension ./hda.vsix --force

# 确认
"/Applications/CodeArts Agent.app/Contents/Resources/app/bin/code" --list-extensions

这个 CLI 也是个 VS Code 的东西,--install-extension、--list-extensions 都能用。它的好处是不依赖图形界面,写进脚本里做环境初始化很方便。

顺便提醒一句:不要从非官方渠道下 VSIX。这个插件里有二进制(opencode 的 sidecar、remote-sign-1.0.0.jar),来源不明的包等于把签名权限交出去。

一周下来的真实分工

如果让我总结这一周怎么用的,大概是这个顺序:

上午读代码、改页面、让 AI 帮忙重构。这一段几乎不切窗口,效率提升明显。

中途需要确认"改完还能不能编译",切到终端跑一次 assembleHap,四秒出头。这一步我在 CodeArts Agent 的终端里也能做,因为构建就是跑命令。

需要看界面时切 DevEco。这一步躲不掉,但也不是每次都看——预览器能解决大部分"布局对不对"的问题,只有涉及权限、分布式、传感器这些真机行为时才需要跑模拟器。

晚上收尾时用 DevEco 做一次完整验证并出包。

一天里,切走的次数从"每次改都要切"降到"三四次"。这就是它给我的实际价值:不是替代,是把需要切换的次数压下来。

关于"AI 编码"这件事的一点看法

用了一周,我对 AI 编码工具的期待变了。

以前我期待它是"更聪明的自动补全",最好能一次把页面写完。现在我更看重它能不能读懂工程——能不能告诉我这个字段该写在哪一层、这个报错对应哪个文件、这个工程到底是怎么组织起来的。

原因很简单:写代码的部分,随着模型变强,差距在缩小。但"知道鸿蒙工程的配置分几层、每层的 schema 长什么样、构建时哪个任务会失败",这类知识不是模型自带的,是工具链给的。

CodeArts Agent 在这件事上的做法挺聪明:它不自己实现鸿蒙,而是把 DevEco 的语言服务接过来。所以它的"懂鸿蒙",其实是 DevEco 的"懂鸿蒙"。

这也解释了一个现象:它的能力上限,恰好等于 DevEco 愿意暴露出来的那部分。

如果重来一次,我会这么配

把这一周的弯路压成五步,照着做大概二十分钟:

第一步,把 app 放到 /Applications。 不要在下载目录里直接跑,隔离和 TCC 会给你制造找不出原因的故障。

第二步,装官方插件。 在线就搜,离线就下 VSIX 手动装。

第三步,配 arkts.deveco.path 到 Contents。 记住是 Contents 那一层,不是 .app。同时把 harmonybot.agentSettings.devEcoStudio.installPath 也设成同一个值。

第四步,验语言服务。 打开任意 .ets 文件,看插件日志目录下有没有 server/idea-lsp-server.log 在滚动。有,说明接上了;没有,回去查路径。

第五步,把构建做成任务。 在工程根目录建 .vscode/tasks.json,Ctrl+Shift+B 就能编译:

{
  "version": "2.0.0",
  "options": {
    "cwd": "${workspaceFolder}",
    "env": {
      "NODE_HOME": "/Applications/DevEco-Studio.app/Contents/tools/node",
      "DEVECO_SDK_HOME": "/Applications/DevEco-Studio.app/Contents/sdk"
    }
  },
  "tasks": [{
    "label": "鸿蒙: 构建 debug HAP",
    "type": "shell",
    "command": "/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw",
    "args": ["--mode", "module", "-p", "product=default",
             "-p", "module=entry@default", "-p", "buildMode=debug",
             "assembleHap", "--no-daemon"],
    "group": { "kind": "build", "isDefault": true },
    "problemMatcher": []
  }]
}

注意两个细节:环境变量必须显式给,否则 hvigor 会去找系统 PATH 里的 node;任务能不能跑取决于工作区是否受信任,不受信任时按快捷键是没有任何反应的(我第一次就卡在这)。

关于"效率"的一点自我怀疑

写到最后我有点犹豫:这一周到底更快了没有?

诚实的答案是"不确定"。省下来的是切换窗口和查配置的时间,花出去的是等语言服务启动、等它重启、以及判断"这段代码是不是 AI 写好但我没看懂"的时间。

后一项比想象中贵。用 AI 补全的时候,最容易发生的不是它写错,而是它写得挺对、你也就没细看。等到出问题回头追,才发现自己并不理解那段代码。鸿蒙这套东西的坑又特别多——配置分层、权限、签名,一个"看起来对"的实现,很可能在真机上不成立。

所以这一周之后我给自己定了个规矩:AI 可以写,但每一段我都要能讲清楚它在做什么。 讲不清的,宁可自己重写一遍。这个规矩让我少用了一些自动生成,但排障的时候心态好很多。

第二个自我怀疑是关于"工具忠诚"。我一开始很想要那个运行按钮,觉得没有它这个 IDE 就是残的。用完之后我改主意了:一个工具只要边界清楚、在边界内可靠,它就是好工具。真正让人难受的不是能力少,是边界模糊——你以为它能跑,结果跑不了,那种落差最耗人。

CodeArts Agent 在这一周里给我的,恰恰是"边界清楚"。它不能跑,但它也从不假装能跑。

给想试的人几句话

如果你只是想找个更顺手的编辑器写 ArkTS,它值得一试。装官方插件、配好 arkts.deveco.path,十分钟能到一个可用的状态。

如果你期待它替掉 DevEco,那就别抱希望。没有 debuggers,没有运行按钮,没有签名,也没有设备管理。这不是配置没做对,是产品定位如此。

如果你在做团队落地,我建议把它定位成"IDE 的前置环节":写、读、重构、评审都在这里做,构建验证和真机调试留给 DevEco。分工清楚,两边的优势都能用到。

最后一点:别把"没有运行按钮"当成缺陷。它本来就不是为此设计的。真要说遗憾,我唯一的建议是官方插件那个 command 列表里,能加一个"构建并部署到已连接设备"的动作——不用做调试器,只要把 hvigor 和 hdc 串起来,很多人对它的评价会立刻不一样。

因为这中间的差别,不是"能不能写得更好",而是"能不能跑起来"。开发者对工具的信任,往往就建立在这一个动作上。

写完这篇我打算再试一次:把 devecocli 装上,看看能不能在它的终端里完成一次完整的构建加部署。如果那条路能通,这篇的结论就得改一句——不是"它不能跑",而是"它要靠命令行跑"。到那时候,我大概会把这套流程写进团队的环境初始化脚本里。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐