作为一名大一学生，我参与了开源鸿蒙跨平台训练营，本文是DAY2任务的阶段性学习笔记。目前我已顺利完成全流程开发环境搭建，尚未推进工程创建与部署环节，因此重点记录DevEco Studio、Flutter SDK、VS Code、Git等工具的安装配置过程，以及实操中遇到的基础踩坑点和解决方法。内容以新手视角撰写，力求平实详细，供同阶段学习者参考避坑。

一、前置准备：环境搭建回顾与核心依赖确认

作为开源鸿蒙跨平台开发的基础，环境搭建是首要任务。我参照训练营提供的技术指导手册，逐步完成了核心工具、SDK、驱动及辅助编辑器的配置，确保环境满足后续开发调试需求，具体步骤与细节如下：

1.1 核心工具与SDK配置

  • 开发工具：安装DevEco Studio 5.1版本（鸿蒙一站式开发工具），我在实操中特意选择了非中文路径（C:\Program Files\Huawei\DevEco Studio 5.1），避免后续工程编译出现路径解析错误。之后在Studio的Marketplace中搜索“Flutter For OpenHarmony”插件安装，重启工具后确认模板列表中能显示对应跨平台模板，确保支持工程创建。

  • SDK配置：结合本次多终端需求，我下载了OpenHarmony API 9的Release版本SDK，勾选了“跨平台框架”“多设备适配组件”“工具链”三个核心模块，避免漏装依赖导致工程无法编译。Flutter SDK选择3.13.0稳定版，配置环境变量时除了添加FLUTTER_HOME，还手动将Flutter的bin目录路径添加到系统Path中，重启命令行后验证命令可正常调用。

1.2 VS Code辅助编辑器配置与问题解决

主开发工具用DevEco Studio，VS Code作为辅助编辑器用于处理代码片段。刚开始用VS Code时，频繁出现“无法找到编译器路径”“无法运行代码”的问题，摸索后按以下步骤排查解决，顺利完成配置：

1.2.1 核心问题定位

新手容易忽略编译环境的配置，VS Code无法运行代码，核心就是缺少C语言编译环境（MinGW），且编译器路径未正确关联，加上缺少对应扩展支持。我分两步逐步解决，过程虽绕但能加深对环境配置的理解。

1.2.2 编译环境（MinGW）安装与配置

  1. 安装MinGW：从SourceForge镜像（https://sourceforge.net/projects/mingw/）下载安装器，官网下载速度太慢，新手可优先选镜像。运行安装器后，在「Basic Setup」中勾选「mingw32-gcc-g++」和「mingw32-gdb」核心组件，点击「Installation→Apply Changes」完成安装，默认路径为C:\MinGW，避免手动改路径引发后续问题。

  2. 配置环境变量：找到MinGW的bin目录（C:\MinGW\bin），复制路径后按Win+R输入sysdm.cpl，打开「系统属性→高级→环境变量」，在系统变量Path中新增该路径，保存后重启命令提示符，输入gcc -v，输出版本信息即说明安装成功。

1.2.3 VS Code编辑器配置与问题修复

  1. 安装扩展：打开VS Code，按Ctrl+Shift+X调出扩展面板，搜索并安装微软官方「C/C++」扩展，为代码编译和语法提示提供支持。

  2. 配置编译器路径：打开C语言文件后，按Ctrl+Shift+P输入「C/C++: Edit Configurations (UI)」，在「Compiler path」中手动选择C:\MinGW\bin\gcc.exe，确保编辑器识别编译器。

  3. 修复环境变量关联：若仍提示“无法找到编译器”，新手不用慌，通过VS Code安装程序修复最稳妥。找到安装包（找不到就去官网重新下载，地址https://code.visualstudio.com/Download），双击运行后选择「修改」，勾选「添加到PATH（重启后生效）」「注册为受支持的文件类型的编辑器」，完成后重启电脑，环境变量即可生效。

  4. 运行代码验证：按Ctrl+Shift+B创建编译任务，选择「C/C++: gcc.exe 生成活动文件」，编译完成后在终端（Ctrl+`打开）输入可执行文件名（如a.exe），成功输出结果即配置完成。

补充说明：对大一新手而言，双工具搭配能提升后续开发效率。VS Code侧重快速编辑代码片段，核心的工程编译、多终端部署仍依赖DevEco Studio，目前仅完成工具配置，后续将逐步学习工程开发相关操作。

1.3 Git与Atom编辑器基础配置

Git用于后续代码版本控制，Atom作为辅助编辑器，是物联网开发常用工具。我按步骤完成基础配置，为后续代码管理和开发做好铺垫，具体操作如下：

1.3.1 Git安装与基础配置

  1. 安装Git：从Git官网（https://git-scm.com/）下载适配Windows系统的安装包，新手建议全程选默认选项，重点留意勾选「Add Git to PATH」，这样后续在任意终端都能直接调用Git命令，不用手动配置环境变量，减少出错概率。

  2. 验证安装：打开命令提示符（cmd），输入git --version，若输出类似“git version 2.45.1.windows.1”的版本信息，说明安装成功。刚开始我输错命令导致验证失败，后来核对拼写才解决，新手操作时要注意命令准确性。

  3. 配置用户信息：为了后续代码提交能溯源，在终端执行以下命令，替换为个人姓名和邮箱（建议和后续AtomGit账号信息一致）。我一开始忘了这步，后来看训练营教程才补充，新手容易忽略这类基础配置，记得做完安装后及时设置：

git config --global user.name “【填写你的姓名，例：张三】”
git config --global user.email “【填写你的邮箱，例：zhangsan@xxx.com】”

1.3.2 Atom编辑器安装与插件配置

Atom安装和插件配置比较简单，重点是安装核心插件提升开发效率，步骤如下：

  1. 安装Atom：从Atom官网（https://atom.io/）下载安装包，默认路径安装，勾选创建桌面快捷方式，方便后续启动。

  2. 安装核心插件：打开Atom后，进入「Settings」→「Install」，搜索并安装三个必备插件，新手直接按名称搜索即可，不用纠结其他同类插件：

  • platformio-ide：物联网开发核心插件，支持后续代码编译与设备调试；

  • linter：实时代码检查，能帮新手及时发现语法错误；

  • autocomplete-python：提供Python语法自动补全，适配后续拓展开发需求。

  1. 插件生效：安装完成后重启Atom，确保插件正常加载，新手可打开一个简单代码文件，验证语法提示功能是否生效。

二、环境验证与新手踩坑总结

2.1 环境可用性验证

所有配置完成后，需逐一验证工具和环境是否正常，避免后续开发出现问题：

  1. DevEco Studio与Flutter环境验证：打开DevEco Studio终端，执行以下命令，若均正常输出版本信息，说明配置无误：

验证Flutter环境

flutter --version

验证OpenHarmony开发环境

ohos -v

查看已连接设备

hdc list targets
我曾遇到“ohos -v”命令无效的问题，排查了十几分钟才发现是OHOS_HOME环境变量未配置，补充SDK安装路径（C:\Users\【填写你的电脑用户名】\AppData\Local\Huawei\Sdk）后解决。另外“hdc list targets”若识别不到设备，可重启设备管理器或重新插拔USB线，新手遇到这类问题别急于重启电脑，先排查基础连接和环境变量，能少走不少弯路。

  1. VS Code环境验证：按Ctrl+Shift+B创建编译任务，选择「C/C++: gcc.exe 生成活动文件」，编译完成后在终端输入可执行文件名（如a.exe），能成功输出结果即配置完成。

  2. Git验证：打开cmd输入git --version，输出版本信息即可，确保后续能正常使用Git命令。

DevEco Studio终端验证命令输出结果在这里插入图片描述

在这里插入图片描述

2.2 新手常见踩坑点与解决方法

作为大一新手，首次搭建这类复杂开发环境时踩了不少基础坑，整理如下供同阶段学习者参考：

  • 路径问题：DevEco Studio和工程建议安装在非中文路径，否则可能出现编译错误，我一开始误选中文路径，卸载重装后才解决，浪费了不少时间。

  • 驱动识别问题：开发板驱动安装后必须重启电脑，手机调试需安装HiSuite助手，新手容易忽略这些细节，导致设备无法识别。

  • 环境变量配置问题：Flutter、MinGW等工具均需配置环境变量，且修改后需重启终端或电脑才能生效，建议新手配置后逐一验证，避免后续出现命令无效问题。

  • 命令拼写错误：Git、Flutter命令对拼写要求严格，新手容易输错字符导致验证失败，建议复制命令后修改关键信息，减少拼写错误。

2.3 后续学习规划

目前已完成开发环境全流程搭建，这是开源鸿蒙跨平台开发的基础，也是训练营DAY2任务的核心目标。作为大一学生，我之前只接触过基础的C语言和Python，第一次搭建这类多工具协同的开发环境，耗时近3小时，踩了不少基础坑，但也对开源鸿蒙开发的工具链有了清晰认知。后续将按训练营进度逐步推进：1. 学习Flutter+OpenHarmony跨平台工程创建与基础配置；2. 尝试在模拟器、真机、开发板上完成工程运行验证；3. 学习AtomGit仓库使用，规范提交代码，逐步积累实战经验，为后续参与开源贡献打下基础。

三、核心社区与参考链接

搭建环境过程中，以下社区和链接提供了重要帮助，分享给大家：

  • Flutter For OpenHarmony社区：https://gitee.com/openharmony-sig/flutter（开源鸿蒙Flutter SIG社区，有详细的技术文档和问题解答，适合新手查阅）

  • 开源鸿蒙官方社区：https://ost.51cto.com/（提供跨平台开发技术手册和实战案例，训练营相关资料也可在此查找）

  • VS Code官网：https://code.visualstudio.com/Download（获取最新版安装包，解决编辑器相关问题）

  • Git官网：https://git-scm.com/（新手教程和安装包下载，帮助理解Git基础命令）

欢迎加入开源鸿蒙跨平台社区：
https://openharmonycrossplatform.csdn.net

# flutter # harmonyos # vscode
Logo
人工智能6S服务平台

作为“人工智能6S店”的官方数字引擎，为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐

昇腾Atlas 200设备全流程配置指南：系统烧录、CANN部署与推理实战

通过调试串口进入系统用户名：root密码：Mind@123。

avatar 人工智能6S服务平台

Flutter 框架跨平台鸿蒙开发 - 家庭账单共享本开发教程

expense, // 支出income, // 收入家庭账单共享本是一个简洁实用的Flutter应用，专注于家庭财务管理的核心功能。

avatar 人工智能6S服务平台

Flutter 框架跨平台鸿蒙开发 - 老年健康指南应用开发教程

本教程介绍了老年健康指南应用的开发过程，包括数据模型设计、核心功能实现、UI组件构建等。应用专为老年人设计，界面简洁友好，内容实用全面，是一个很好的健康管理工具。欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net。

avatar 人工智能6S服务平台