一、工具链与环境（手把手操作步骤）

学习目标

• 装好 DevEco Studio 并配好 SDK
• 跑通模拟器（或连上真机）
• 创建并运行第一个 Empty Ability 项目
• 看懂工程目录结构

下载链接（唯一官方地址，可点击直达）

• DevEco Studio（鸿蒙 NEXT 开发 IDE）：https://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 12+	Windows 11 / macOS 14
内存	8 GB	16 GB 及以上
硬盘	100 GB 可用（SDK + 模拟器镜像很大）	SSD 固态，256 GB+
其他	能联网（首次要下 SDK）	——

步骤二、下载 DevEco Studio

1. 打开上面的官方下载页，登录华为账号（没有先注册）。
2. 页面下拉找到"DevEco Studio"，选对应系统（Windows 约 1.2 GB / macOS 约 1.5 GB）。
3. 下载完成后校验完整性（页面有校验指引），避免安装包损坏导致后续莫名报错。

步骤三、安装

• Windows：双击 deveco-studio-xxxx.exe → 选安装路径（路径不能含中文和空格，建议 D:\DevEco Studio）→ 勾选 Create Desktop Shortcut 与 Add to PATH → Install → Finish。
• macOS：双击 .dmg → 拖入 Applications → 首次打开若提示"无法打开"，去 系统设置 → 隐私与安全性 点"仍要打开"。

步骤四、首次启动与 SDK 配置（最容易出错的环节）

1. 首次启动若弹 Import DevEco Studio Settings，选 Do not import settings → OK。
2. 同意协议 → Next。
3. 安装类型选 Custom（自定义）→ Next。
4. 设置 SDK 存储路径（同样不能有中文和空格，如 D:\DevEcoStudioSDK）→ Next。
5. 勾选必备组件（全部勾上更省心）：
   • ✅ HarmonyOS SDK（选最新稳定版，如 API 14 / HarmonyOS 5.0）
   • ✅ ArkTS
   • ✅ Toolchains
   • ✅ Emulator（模拟器）
   • ✅ Previewer（预览器）
6. 点 Next → Finish，等待 SDK 自动下载完成（耗时取决于网速，耐心等进度条）。

步骤五、准备运行设备（模拟器或真机，二选一）

方案 A：模拟器（推荐新手，无需实名、无需手机）

1. 菜单 Tools → Device Manager（或右上角设备下拉 → Device Manager）。
2. 切到 Local Emulator → New Emulator → 选一个手机机型（如 Phone，分辨率适中）→ 下载系统镜像（首次需下载，较大）。
3. 创建完成后点 ▶ 启动模拟器，看到手机界面即成功。

方案 B：真机（更接近真实环境）

1. 手机 设置 → 关于手机 → 版本号，连续点击 7 次开启开发者模式。
2. 设置 → 系统和更新 → 开发人员选项 → 打开 USB 调试。
3. 数据线连电脑，手机弹窗选"允许 USB 调试"。

步骤六、创建第一个项目

1. File → New → Create Project（或欢迎页 Create Project）。
2. 模板选 Empty Ability（注意是 Stage 模型、ArkTS 语言），不要选 FA 模型或元服务模板。
3. 填项目名（如 MyFirstApp）、包名（如 com.example.myfirstapp，倒域名格式）、SDK 版本（与步骤四一致）→ Finish。
4. 等待 Hvigor 同步与依赖下载（首次较慢，右下角有进度）。

步骤七、修改首页文字

1. 左侧文件树展开 entry → src → main → ets → pages → Index.ets。
2. 找到类似 Text('Hello World') 的那行，改成 Text('我的第一个鸿蒙应用')。
3. 保存（Ctrl/Cmd + S）。

步骤八、运行

1. 顶部设备下拉选你启动的模拟器（或已连接的真机）。
2. 点 ▶ Run（或 Shift + F10）。
3. 等编译安装完成，模拟器/真机出现你的页面，显示"我的第一个鸿蒙应用"。

必须认识的文件（后续天天打交道）

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）

常见坑（提前避）

1. 安装/SDK 路径绝不能有中文或空格，否则各种诡异报错。
2. 必须用 SSD；机械硬盘会导致 SDK 下载慢、编译卡、模拟器起不来。
3. 内存 8 GB 只能勉强跑，开发体验差，建议 16 GB+。
4. 不用单独装 Node.js：DevEco 自带，单独装版本不匹配反而踩坑。
5. 首次启动卡在下载 SDK：检查网络/代理，必要时 File → Settings → HTTP Proxy 配置。
6. 模拟器起不来：确认电脑开了虚拟化（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-install

2. 官方文档

• HarmonyOS 应用开发指南（harmonyos-guides，认准 NEXT/Stage）：https://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