常见报错速查

症状	原因 → 解决
编译报 `@style/Theme.*` 或 `@string/app_name` 资源缺失	Manifest 残留了 theme/label 属性引用 → 新规范下 application 无任何属性，删掉残留行
编译报 `ic_launcher_round` 缺失	Manifest 写了 `roundIcon` 但按新规范没这个资源 → 删掉那行
运行时 `NoSuchMethodError`（宿主/插件之间）	UI组件或插件框架改了没重新发布 AAR，宿主与插件版本错位 → 发布三连：发布 AAR → 重编宿主 → 重编插件
深色模式不生效	入口直接用了 `HuaLuoTheme` → 换 `PluginTheme`
构建显示 UP-TO-DATE 但改动没生效	本仓 Gradle 假 UP-TO-DATE 前科 → 加 `--rerun-tasks`
Kotlin 源码中文注释乱码	文件带 BOM 或 ANSI 编码 → 用 `[IO.File]::WriteAllText` + `UTF8Encoding($false)` 重写
权限相关功能不工作	以为插件 Manifest 里声明权限就有 → 权限只能宿主声明授予；确认宿主侧已具备
GenerateProjectAccessors 超时 / `does not specify compileSdk` 误导报错	为没用到私有目录的模块注册了版本目录 → 删掉没用的 `gradle/libs.versions.toml` 注册

常见报错速查 ​