鸿蒙系统 DevEco Studio 安装及项目创建教程：从效果到操作

一、最终效果预览

完成所有操作后，你将获得以下成果：

• 成功安装鸿蒙应用开发工具DevEco Studio，界面支持中文显示；
• 创建首个鸿蒙项目，通过实时预览器查看效果；
• 可自定义修改代码内容，例如将默认文字改为 “Hello HUAWEI”“遥遥领先” 等，预览器实时同步显示修改结果。

以下是最终效果示例图：

二、详细操作步骤（小白友好版）

阶段 1：下载 DevEco Studio 安装包

1.打开浏览器，进入华为开发者联盟官网的 DevEco Studio 页面：
网址：DevEco Studio-鸿蒙应用集成开发环境（IDE）-华为开发者联盟

2.点击页面中的 “立即下载” 按钮；

3.在下载选项中，选择适合 Windows 系统的版本（文档中示例为deveco-studio-5.1.0.849.exe），等待下载完成。

阶段 2：安装 DevEco Studio

1.找到下载完成的压缩包，直接点进去找到deveco-studio-5.1.0.849.exe应用程序双击；

2.若弹出 “压缩文件夹提示”，点击 “运行 (R)”；

3.若弹出 “安全警告”，确认发行商为Huawei Technologies Co., Ltd.后，点击 “运行 (R)”；

4.进入安装向导：

• 点击 “下一步 (N)”；
• 到 “安装选项” 页面时，勾选所有选项（包括 “创建桌面快捷方式”“添加 bin 文件夹到 PATH” 等），然后点击 “下一步 (N)”；

• 安装完成后，会提示 “必须重启本机”，选择 “否，我会在之后重新启动 (N)”，点击“完成 (F)”。

阶段 3：首次启动与基础配置

1.双击桌面快捷方式打开 DevEco Studio；

2.若弹出 “导入配置文件” 窗口（首次安装可能不显示），选择 “Do not import settings”（不导入之前的配置），点击“OK”；

3.阅读用户协议后，勾选同意条款，点击 “Agree”；

4.进入欢迎界面，点击 “Create Project”（创建新项目）。

阶段 4：创建首个鸿蒙项目

1.在 “选择模板” 页面：

• 左侧选择 “Application”（应用程序）；
• 右侧选择 “Empty Ability”（空白能力模板，基础 Hello World 功能），点击“Next”；

2.项目创建完成后，会自动进入代码编辑界面，默认显示ets文件（路径：entry/src/main/ets/pages/Index.ets）。

阶段 5：设置中文界面（小白必看）

1.在顶部菜单栏点击 “File”（文件），选择“Settings...”（设置，快捷键Ctrl+Alt+S）；

2.在设置窗口左侧，找到并点击 “Plugins”（插件），点击顶部的 “Installed”（安装），在搜索框中输入“chi”；

3.在搜索结果中找到 “Chinese (Simplified)”（中文语言包），勾选启用，点击“OK”；

4.弹出 “重启提示”，点击“Restart”（重启 DevEco Studio）；

5.重启后界面自动变为中文，若弹出 “每日小技巧”，选择 “不显示” 并关闭即可。

阶段 6：使用预览器、放大 / 缩小画面与修改代码

1.打开预览器：在代码编辑界面右侧或底部，找到 “预览器” 选项卡，点击打开；

2.首次打开预览器会显示 “Loading preview”，等待片刻（编译需要时间）；

3.修改代码内容（示范）：

• 在ets文件中，找到第 4 行代码：@State message: string = 'Hello World';；
• 将'Hello World'改为自定义内容，例如'Hello HUAWEI'或'Hello 遥遥领先'；
• 按Ctrl+S保存修改，预览器会实时同步显示新内容。

4.右上角可调整预览画面大小

阶段 7：清空默认代码，从头编写（可选）

若想从零开始编写代码：

1.在ets文件中，删除第 4 行和第 7-21 行的默认代码；

2.输入基础代码示例（如图）：

3.按Ctrl+S保存，预览器中会显示 “遥遥领先” 文字，可通过步骤 2 的放大 / 缩小功能调整画面大小。

注意事项，不按Ctrl+S保存没有效果

三、预览器故障解决方法

编写过程中若预览器显示 “Preview failed” 或 “Disconnected from the engine”：

解决方法：

1.关闭当前预览器窗口；

2.重新点击 “预览器” 选项卡打开，等待重新编译加载即可恢复正常。

四、智能分析功能：代码错误排查（新手必备）

当代码存在问题导致预览器报错且看不懂错误信息时，可使用 DevEco Studio 的 智能分析工具（CodeGenie） 排查问题：

适用场景

预览器报错（如 “Preview failed”“资源名称无效” 等），且不清楚错误原因。

操作步骤

1.打开智能分析工具：在代码编辑界面右侧或底部，找到“CodeGenie” 图标（AI 入口），点击打开；

2.登录华为账号：首次使用需登录华为账号（已登录可跳过）；

3.描述问题或直接查看分析结果：

• 工具会自动识别代码错误，在输出区域显示问题原因（如资源名称包含非法字符、语法错误等）；
• 同时提供修改建议，例如提示资源名称需符合[a-zA-Z0-9_] 规则，并举例修改后的正确名称（如将 3-HUAWEI Pura 80 Pro-4x 改为 huawei_pura_80_pro_4x）。

4.修改资源名称（DevEco 特有操作）：

• 右键点击需修改的资源文件（如图片），选择“重构 (R)”→“重命名 (R)”（快捷键 Shift+F6）；
• 输入符合规则的新名称（不含空格、特殊符号），按 Enter 确认即可。

根据建议修改代码后，按 Ctrl+S 保存，重新打开预览器即可正常显示。

五、总结

通过以上步骤，你已完成 DevEco Studio 的安装、中文配置、首个项目创建及预览器使用，掌握了基础的代码修改和故障处理方法。后续可基于空白模板继续探索鸿蒙应用开发功能！