Flutter Android项目styles.xml中Unknown word(CssSyntaxError)错误修复

解决办法 #

• 先定位错误根源：打开自动生成的styles.xml，检查第5行的item标签内容，确认是否存在语法错误（比如引号不闭合、多余符号、属性名写错，或是混入了CSS格式的代码）。Android的styles.xml item标签规范格式应为：

  <item name="android:属性名">属性值</item>
  

• 清理构建缓存，强制重新生成配置文件：

  1. 执行flutter clean清除Flutter项目缓存
  2. 删除Android模块下的build文件夹和.gradle子文件夹
  3. 运行flutter pub get重新拉取依赖，再执行flutter run让框架重新生成正确的styles.xml

• 排查版本兼容性问题：

  • 升级Flutter到最新稳定版：flutter upgrade
  • 检查android/build.gradle中的Gradle插件版本，确保与当前Flutter版本匹配（比如Flutter 3.x系列建议使用Gradle 7.0+版本）

• 手动覆盖自动生成的样式配置：
  如果重新生成后错误依旧，在android/app/src/main/res/values/目录下创建自定义的styles.xml，写入正确的样式配置，框架会优先使用这个文件，避免自动生成的错误内容干扰

• 检查关联资源文件：
  如果错误涉及到启动背景（如launch_background），对应的drawable资源文件可能存在语法错误（比如SVG里的CSS代码格式问题），替换或修复该资源文件即可

内容的提问来源于stack exchange，提问作者Kings Samuel