鸿蒙从零搭建参赛项目｜心晴驿站：开发环境配置、技术选型与项目规范落地

一、前言

在上一篇专栏中，我们完整梳理了心晴驿站 的项目缘起、产品差异化定位、整体功能架构与技术专栏全局规划。明确了本项目是纯鸿蒙端侧原生、离线可用、高隐私轻量化的心理健康治愈应用，专为2026鸿蒙应用开发者激励计划打造。

本篇作为系列第二篇，聚焦项目落地第一步 ：从零完成鸿蒙开发环境搭建、技术栈精准选型、项目初始化搭建与全局开发规范统一。针对零基础鸿蒙开发、个人Solo参赛开发场景，规避新手常见踩坑点，搭建一套规范、稳定、可迭代的鸿蒙原生项目底座，为后续所有业务功能开发筑牢基础。

本文所有配置、选型、操作流程均为项目实战落地版本，无空泛理论，可直接复刻用于鸿蒙参赛项目、原生应用开发学习。

二、项目核心技术选型（精准避坑版）

很多鸿蒙开发新手极易出现技术栈混用、模型选错、依赖冗余 的问题，导致后续无法上架、适配报错、项目重构返工。因此在正式开发前，先明确心晴驿站的最终定型技术方案，全程贴合鸿蒙官方最新标准与激励计划参赛要求。

2.1 核心技术栈最终选型

结合项目「轻量化端侧应用、离线运行、高隐私、低功耗」的核心特性，最终放弃跨端框架、老旧JS开发模型、前后端分离架构，采用纯鸿蒙原生技术栈：

开发语言：ArkTS（首选，鸿蒙原生增强型TS，强类型、高稳定、适配所有新特性）
UI开发框架：ArkUI 声明式UI（极简代码、组件复用性强、动画交互流畅）
应用核心模型：Stage模型（鸿蒙官方主推模型，替代老旧FA模型，适配新版SDK、上架兼容性更强）
开发IDE：DevEco Studio 最新正式版
适配SDK版本：HarmonyOS 6.0.2(22) 及以上
数据存储方案：鸿蒙原生Preferences首选项 + 端侧本地数据库（纯本地存储，无云端依赖）
调试方案：官方Previewer实时预览 + 鸿蒙真机模拟器双重调试

2.2 技术选型核心考量（为什么这么选？）

1. 放弃跨端框架，坚持纯原生开发

目前市面多数心理类工具APP采用UniApp、Flutter等跨端方案，虽然开发效率高，但存在运行冗余、原生特性适配不全、动画卡顿、上架审核权重低等问题。

心晴驿站主打治愈流畅的交互体验、轻量化低功耗，且作为鸿蒙参赛项目，原生开发能最大化适配鸿蒙系统特性，提升应用流畅度、稳定性，同时契合鸿蒙激励计划对原生生态应用的扶持导向。

2. 放弃FA模型，全面使用Stage模型

FA模型为鸿蒙老旧开发模型，已逐步被官方淘汰，存在组件生命周期混乱、权限管理薄弱、多设备适配差、无法适配新版SDK等问题。

Stage模型具备架构分层清晰、权限管控严格、组件解耦性高、适配性强的优势，完美适配心理健康类应用的隐私安全、稳定运行需求，也是目前鸿蒙应用上架的主流标准。

3. 纯端侧无后端架构，贴合产品定位

区别于常规需要服务器、数据库、接口的项目，本项目采用全本地端侧架构。所有测评算法、情绪记录、游戏逻辑、树洞功能均在本地设备运行，无需联网、无需后端服务，既契合产品「离线可用、零隐私上传」的核心卖点，又大幅简化项目架构、降低部署与维护成本。

2.3 新手绝对避坑的技术误区

整理鸿蒙参赛开发高频错误，全程规避，保证项目合规可上架：

❌ 错误：使用Java/Kotlin、Swift、Vue/React等跨端技术开发鸿蒙应用
❌ 错误：使用老旧FA模型搭建新项目
❌ 错误：大量引入第三方冗余依赖，导致应用包体过大、运行卡顿
❌ 错误：依赖云端存储用户敏感情绪数据，存在隐私合规风险
✅ 正确：ArkTS+ArkUI+Stage模型纯原生开发，轻量化、纯本地、高合规

三、开发环境从零搭建实战

本次搭建全程适配Windows系统，为零基础鸿蒙开发者提供一站式复刻方案，无需额外配置复杂环境。

3.1 工具下载与安装

1. DevEco Studio 安装

前往华为开发者联盟官网，下载最新正式版DevEco Studio，安装过程默认勾选Node.js、Hvigor构建工具、OHPM包管理器，无需单独配置环境变量，实现开箱即用。

安装完成后，首次启动完成初始化配置，选择中文界面、默认主题，适配国内开发习惯。

2. HarmonyOS SDK 配置

打开IDE设置，进入SDK配置界面，安装**HarmonyOS 6.0.2(22)**及以上版本SDK，同步安装配套的工具链、模拟器插件，保证项目编译、调试、预览全流程正常运行。

3. 开发者账号准备

注册华为开发者联盟个人账号，完成实名认证，为后续应用上架、商户服务开通、激励计划报名提前做好准备。

3.2 调试环境配置

实时预览调试：开启IDE内置Previewer，支持代码实时刷新、页面动态预览，无需反复编译，大幅提升开发效率；
模拟器调试：启动鸿蒙手机模拟器，适配屏幕分辨率、系统版本，测试页面适配、交互逻辑、动画效果；
真机调试（可选）：连接鸿蒙真机设备，测试真实机型的运行流畅度、适配兼容性。

四、项目初始化与标准化目录搭建

环境搭建完成后，进行项目初始化，摒弃默认杂乱目录，搭建一套适配心理应用业务、分层清晰、高解耦、可迭代的标准化目录结构，完全适配Solo开发与长期迭代。

4.1 项目创建流程

打开DevEco Studio，新建项目，选择「Stage模型-Empty Ability」空模板；
语言选择ArkTS，取消多余默认模板依赖；
项目命名为「XinQingYiZhan」，统一小写驼峰命名，符合鸿蒙开发规范；
等待项目初始化完成，清理默认冗余代码、无用注释、多余示例页面。

4.2 标准化目录结构（最终落地版）

结合项目四大业务模块，重构优化目录，实现层级分明、业务隔离、组件复用、逻辑解耦：

plain 复制代码

xinqingyizhan/
├── AppScope/                # 应用全局配置与资源
│   └── resources/           # 全局图片、颜色、字符串资源
├── entry/
│   └── src/main/
│       ├── ets/
│       │   ├── entryability/     # 应用入口Ability，管控应用生命周期
│       │   ├── pages/            # 核心业务页面（首页/测评/游戏/我的）
│       │   ├── components/       # 全局公共复用组件（卡片、弹窗、导航栏等）
│       │   ├── models/          # 数据模型、类型定义（测评数据、情绪数据）
│       │   ├── utils/           # 全局工具函数（时间格式化、数据计算）
│       │   ├── constant/        # 全局常量（文案、配色、测评题库常量）
│       │   ├── store/           # 全局状态管理
│       │   └── service/         # 业务逻辑层（测评算法、游戏逻辑、存储封装）
│       └── module.json5         # 项目模块配置
├── hvigor/                    # 构建配置目录
└── product/                   # 产品打包配置

4.3 目录设计核心优势

业务隔离：页面、组件、逻辑、数据、资源完全分层，避免代码耦合；
复用性强：公共组件、工具函数、常量统一管理，减少冗余代码；
迭代友好：后续新增功能、优化逻辑可直接对应模块扩展，无需重构整体架构；
规范统一：完全契合鸿蒙官方开发规范，适配编译、打包、上架全流程。

五、全局开发规范统一（团队级标准，个人开发提质增效）

为避免后期代码混乱、风格杂乱、迭代维护困难，项目初始化后统一全局开发规范，适配长期开发与复盘迭代。

5.1 命名规范

文件/文件夹：统一小写驼峰命名，如 moodRecord、bubbleGame；
组件名称：大驼峰命名，如 MoodCard、GameItem；
变量/函数：小驼峰命名，语义化命名，禁止拼音、无意义简写；
常量：全大写+下划线分隔，如 MAX_SCORE、DEFAULT_COLOR。

5.2 代码规范

严格遵循ArkTS强类型规范，所有变量、函数定义明确类型，杜绝any类型滥用；
页面、组件、功能单独拆分文件，单个文件代码行数可控，避免超大文件；
业务逻辑与UI渲染分离，逻辑统一封装至service/utils，保证页面简洁；
统一代码缩进、空行、注释规范，关键业务逻辑（测评算法、树洞清空逻辑）添加详细注释。

5.3 资源规范

所有图片、配色、文案统一放入全局资源文件，禁止代码硬编码；
图片统一压缩处理，保证应用轻量化、低内存占用；
配色统一遵循项目「轻、柔、暖」治愈风格，全局统一主题色。

六、初始化阶段核心踩坑复盘

作为零基础鸿蒙开发选手，在项目初始化与环境搭建阶段，总结2个高频踩坑点，帮大家规避返工问题：

6.1 版本不兼容问题

初期使用过低SDK版本，导致部分动画API、本地存储API无法使用，后续升级SDK后解决。建议新手直接适配最新稳定版SDK，提前规避版本兼容问题。

6.2 目录混乱导致耦合严重

初始使用默认模板目录，业务逻辑、UI代码、工具函数混杂，代码极度混乱。重构分层目录后，代码解耦、开发效率大幅提升。新项目务必先规整目录，再进行业务开发。

七、本篇总结与下篇预告

本篇我们完成了心晴驿站项目的技术栈定型、开发环境搭建、项目初始化、目录架构规整、全局规范统一，搭建了一套规范、稳定、适配参赛标准的鸿蒙原生项目底座，彻底规避新手开发的常见误区，为后续架构设计、页面开发、功能落地奠定基础。

下一篇（专栏第三篇）将重点拆解：鸿蒙Stage模型深度解析 + 心晴驿站整体分层架构设计，从架构层面讲解项目的设计思路、分层逻辑、隐私安全架构与可迭代设计，深入理解鸿蒙原生应用的架构核心。