开始鸿蒙开发，总会遇到各种“拦路虎”：SDK下载失败、编译报错、模拟器起不来。这些问题大多有标准解法，这篇把最常见的十个问题一次解答。
环境类问题
- SDK下载慢/失败：配置镜像或代理，多试几次；
- 模拟器无法启动：BIOS开启虚拟化（VT-x/AMD-V）；
- 真机连不上：开启开发者模式+USB调试，换数据线（要数据线非充电线）；
- IDE卡顿：内存不足，升级到16GB或关闭其他程序。
编译类问题
构建报错：看错误日志（Build窗口），多数是依赖或SDK版本问题；Gradle同步失败：检查网络和代理，或用本地仓库；签名报错：证书和包名不匹配，重新生成配置；API版本不匹配：检查build-profile的SDK版本。
运行类问题
应用闪退：看Logcat的崩溃日志（找Exception）；页面空白：检查@Entry和build()；UI不刷新：状态变量没用@State；真机安装失败：签名不匹配（调试签名vs发布签名）。
代码类问题
import找不到：检查依赖（oh-package.json5）和SDK；组件不显示：检查布局容器（Column/Row）和尺寸；事件不触发：检查onClick绑定；API调用报错：查文档确认API版本支持。
求助渠道
官方文档（华为开发者）；开发者社区（论坛、问答）；Gitee示例代码；错误信息复制到搜索（英文报错搜英文）。遇到问题先看日志——日志会告诉你答案。
鸿蒙开发的问题九成能自查：看日志、查文档、搜错误信息。环境、编译、运行三类问题的解法有规律，按类排查，新手也能快速“通关”。