本文基于 HarmonyOS 6.1 (API 23) 进行开发实践记录了从 DevEco Studio 安装到首次运行的全过程重点复盘了 SDK 安装过程中遇到的 Lock 文件报错解决方案。一、前言作为一名刚接触鸿蒙生态的开发者为了参与共创季稿事节活动我从零开始搭建 HarmonyOS 开发环境。本文不聊复杂的业务逻辑专注于新手最头疼的环境配置环节特别是针对安装过程中出现的.lock文件报错提供一种有效的解决思路。二、环境准备为了保证开发环境的规范性本次搭建采用了以下配置符合活动要求的 API 23 标准操作系统Windows 11DevEco Studio 版本6.1.0Compile SDKHarmonyOS 6.1.0 (API 23)开发语言ArkTS三、安装过程中的典型报错与解决在安装 HarmonyOS SDK 及模拟器镜像时DevEco Studio 弹出了如下报错Cannot install system-image.HarmonyOS-6.0.31.phone_all_x86, because it has been locked by other process.问题分析这个报错意味着 SDK 的临时文件夹.temp被后台的某个进程占用了导致安装程序无法写入数据。这通常发生在初次安装时后台线程冲突或者上次软件非正常关闭导致的残留。解决方案终止进程首先关闭 DevEco Studio打开任务管理器结束所有与Java或Huawei相关的后台进程。清理缓存按照报错提示的路径C:\Users\[用户名]\AppData\Local\Huawei\Sdk\.temp\手动删除.temp 文件夹内的所有内容。重启软件重新打开 DevEco Studio进入 SDK Manager重新勾选对应的 System Image 进行下载。经过上述步骤SDK 顺利安装成功。这一踩坑经历提醒我们在 Windows 环境下开发时注意后台进程管理非常重要。四、创建并运行首个应用4.1 项目配置启动 DevEco Studio点击Create Project选择Application下的Empty Ability模板关键配置如下ModelStage当前主流模型LanguageArkTSCompile SDK6.1.0(API 23)务必确认此项否则不符合投稿要求Device TypePhone4.2 核心代码解析创建完成后打开entry/src/main/ets/pages/Index.ets默认的入口代码如下。这段代码定义了一个简单的页面包含一个响应式的文本组件Entry Component struct Index { // State 修饰的变量是响应式的当其值改变时UI会自动刷新 State message: string Hello World build() { RelativeContainer() { Text(this.message) .fontSize(50) .fontWeight(FontWeight.Bold) .alignRules({ center: { anchor: __container__, align: VerticalAlign.Center }, middle: { anchor: __container__, align: HorizontalAlign.Center } }) } .height(100%) .width(100%) } }对于新手来说理解State装饰器和build()布局函数是入门 ArkTS 的第一步。4.3 运行效果由于本地模拟器环境配置较为复杂为了确保稳定性本次运行采用Remote Emulator远程模拟器​ 进行调试。启动远程设备后点击 Run 按钮应用在华为手机模拟器中成功运行界面显示经典的 Hello World。五、总结本次环境搭建虽然遇到了 SDK Lock 文件的阻碍但通过手动清理缓存的方式成功解决。对于新手而言如果本地模拟器运行不畅直接使用云端远程模拟器是一个高效且稳定的替代方案。后续我将基于此环境进一步探索 ArkTS 的语法特性和 Stage 模型的开发流程争取产出更多高质量的鸿蒙技术文章。