先执行 hdc install xxx.hap 并完整阅读输出（可加 -r 覆盖安装）。不同报错对应不同原因，不要盲试。

报「安装被禁止」类错误：设备开启了「纯净模式」（增强防护），系统级禁止安装非应用市场来源的 HAP。

解决：设置 → 安全 → 更多安全设置 → 纯净模式 → 关闭（增强防护）。关闭后重新 hdc install。

• 报「签名校验失败 / failed to install」：HAP 需要用签名后的包安装，自研应用在 DevEco Studio 中配置签名（自动签名需登录华为开发者账号）；
• NEXT 对签名校验更严格，未签名 / 签名不符直接失败，这不是驱动问题；
• 直接安装第三方未签名 HAP 不被系统允许，属安全机制。

目标设备的 API 版本低于 HAP 要求时会拒装：用 hdc shell 进入后查看系统版本，或降低工程的 compatibleSdkVersion 重新构建。

清理后重新 hdc install -r。设备开了多用户/隐私空间时，默认装到当前活跃用户；需要指定用户用 hdc install -u 用户ID -r xxx.hap。

把 HAP 拖到终端时若路径带中文或空格，用英文引号包裹整个路径，或先把 HAP 复制到简单路径（如 D:\tmp\）再安装。中文文件名传输乱码属 hdc 版本问题，升级 SDK 到 3.1.0a 以上。