目录一、工具链与环境手把手操作步骤学习目标下载链接唯一官方地址可点击直达步骤一、确认电脑配置步骤二、下载 DevEco Studio步骤三、安装步骤四、首次启动与 SDK 配置最容易出错的环节步骤五、准备运行设备模拟器或真机二选一步骤六、创建第一个项目步骤七、修改首页文字步骤八、运行必须认识的文件后续天天打交道常见坑提前避二、参考学习链接1. 官方下载2. 官方文档3. 社区与踩坑4. Markdown 写作参考CSDN 发布用一、工具链与环境手把手操作步骤学习目标装好 DevEco Studio 并配好 SDK跑通模拟器或连上真机创建并运行第一个 Empty Ability 项目看懂工程目录结构下载链接唯一官方地址可点击直达DevEco Studio鸿蒙 NEXT 开发 IDEhttps://developer.huawei.com/consumer/cn/deveco-studio/华为开发者账号首次启动需登录免费注册https://developer.huawei.com/consumer/cn/说明DevEco Studio 已开箱即用地内置Node.js、ohpm鸿蒙包管理器、HarmonyOS SDK、Hvigor 构建工具与模拟器平台新手无需单独安装 Node.js。步骤一、确认电脑配置项目最低要求推荐系统Windows 10/11 64 位 或 macOS 12Windows 11 / macOS 14内存8 GB16 GB 及以上硬盘100 GB 可用SDK 模拟器镜像很大SSD 固态256 GB其他能联网首次要下 SDK——步骤二、下载 DevEco Studio打开上面的官方下载页登录华为账号没有先注册。页面下拉找到DevEco Studio选对应系统Windows 约 1.2 GB / macOS 约 1.5 GB。下载完成后校验完整性页面有校验指引避免安装包损坏导致后续莫名报错。步骤三、安装Windows双击deveco-studio-xxxx.exe→ 选安装路径路径不能含中文和空格建议D:\DevEco Studio→ 勾选Create Desktop Shortcut与Add to PATH→ Install → Finish。macOS双击.dmg→ 拖入Applications→ 首次打开若提示无法打开去系统设置 → 隐私与安全性点仍要打开。步骤四、首次启动与 SDK 配置最容易出错的环节首次启动若弹Import DevEco Studio Settings选Do not import settings→ OK。同意协议 → Next。安装类型选Custom自定义→ Next。设置 SDK 存储路径同样不能有中文和空格如D:\DevEcoStudioSDK→ Next。勾选必备组件全部勾上更省心✅ HarmonyOS SDK选最新稳定版如 API 14 / HarmonyOS 5.0✅ ArkTS✅ Toolchains✅ Emulator模拟器✅ Previewer预览器点 Next → Finish等待 SDK 自动下载完成耗时取决于网速耐心等进度条。步骤五、准备运行设备模拟器或真机二选一方案 A模拟器推荐新手无需实名、无需手机菜单Tools → Device Manager或右上角设备下拉 →Device Manager。切到Local Emulator→New Emulator→ 选一个手机机型如 Phone分辨率适中→ 下载系统镜像首次需下载较大。创建完成后点 ▶ 启动模拟器看到手机界面即成功。方案 B真机更接近真实环境手机设置 → 关于手机 → 版本号连续点击 7 次开启开发者模式。设置 → 系统和更新 → 开发人员选项 →打开USB 调试。数据线连电脑手机弹窗选允许 USB 调试。步骤六、创建第一个项目File → New → Create Project或欢迎页Create Project。模板选Empty Ability注意是Stage 模型、ArkTS 语言不要选 FA 模型或元服务模板。填项目名如MyFirstApp、包名如com.example.myfirstapp倒域名格式、SDK 版本与步骤四一致→ Finish。等待 Hvigor 同步与依赖下载首次较慢右下角有进度。步骤七、修改首页文字左侧文件树展开entry → src → main → ets → pages → Index.ets。找到类似Text(Hello World)的那行改成Text(我的第一个鸿蒙应用)。保存Ctrl/Cmd S。步骤八、运行顶部设备下拉选你启动的模拟器或已连接的真机。点 ▶ Run或Shift F10。等编译安装完成模拟器/真机出现你的页面显示我的第一个鸿蒙应用。必须认识的文件后续天天打交道entry/src/main/ets/ entryability/EntryAbility.ts # 应用入口UIAbility 生命周期 pages/Index.ets # 首页 UI你主要改这里 entry/src/main/resources/ # 图片、字符串、布局等资源 entry/src/main/module.json5 # 模块配置权限、ability 声明 AppScope/ # 全局应用配置 oh-package.json5 # 依赖声明类似 package.json常见坑提前避安装/SDK 路径绝不能有中文或空格否则各种诡异报错。必须用SSD机械硬盘会导致 SDK 下载慢、编译卡、模拟器起不来。内存 8 GB 只能勉强跑开发体验差建议 16 GB。不用单独装 Node.jsDevEco 自带单独装版本不匹配反而踩坑。首次启动卡在下载 SDK检查网络/代理必要时File → Settings → HTTP Proxy配置。模拟器起不来确认电脑开了虚拟化BIOS 中 VT-x/AMD-V且与其他安卓模拟器如雷电、夜神未冲突。实操任务按上面 8 步走完 → 首页显示我的第一个鸿蒙应用。验收模拟器/真机显示该文字且你能在文件树里指认Index.ets和module.json5。二、参考学习链接1. 官方下载DevEco Studio 官方下载唯一地址https://developer.huawei.com/consumer/cn/deveco-studio/华为开发者账号注册https://developer.huawei.com/consumer/cn/DevEco Studio 下载与安装官方说明https://device.harmonyos.com/cn/docs/apiref/harmonyos-guides/ide-software-install2. 官方文档HarmonyOS 应用开发指南harmonyos-guides认准 NEXT/Stagehttps://developer.huawei.com/consumer/cn/doc/harmonyos-guides仓颉编程语言官网https://cangjie-lang.cn/3. 社区与踩坑华为开发者论坛https://developer.huawei.com/consumer/cn/forum/CSDN 鸿蒙专区 / 51CTO 鸿蒙开发者社区检索报错、案例与性能实测4. Markdown 写作参考CSDN 发布用Markdown 基础语法CSDN 文章排版参考https://blog.csdn.net/weixin_45494811/article/details/104307670