Material Design从1.7.0升级至1.8.0后布局预览无法显示

• 先排查废弃API：1.8.0版本移除或修改了1.7.0中的部分布局组件API，比如部分布局管理器配置、组件属性名，对照官方迁移文档替换未适配的旧代码。
• 检查主题样式冲突：新版本调整了默认主题的间距、尺寸或颜色变量，确认自定义主题中是否有覆盖的样式未适配新变量（比如md_surface_container这类新颜色标识）。
• 核对依赖兼容性：确保项目中AndroidX、Jetpack等依赖库（如androidx.core、androidx.appcompat）的版本与Material Design 1.8.0兼容，必要时同步升级这些依赖。
• 排查组件行为变更：像BottomNavigationView、ChipGroup这类组件，新版本可能调整了默认布局逻辑，检查布局文件中硬编码的尺寸、margin值是否导致错位。

快速验证步骤 #

1. 临时回退到1.7.0版本，确认布局恢复正常，排除其他代码改动的影响。
2. 新建空白测试项目，仅引入Material Design 1.8.0并添加相同布局代码，测试是否复现问题，判断是项目配置问题还是组件本身兼容性问题。
3. 用Android Studio的Layout Inspector工具，对比1.7.0和1.8.0版本下布局的测量尺寸、约束关系差异。

常见问题修复示例 #

如果是MaterialCardView默认内边距变更导致布局错位，可在布局中显式设置内边距：

<com.google.android.material.card.MaterialCardView
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp"
    app:cardElevation="4dp">
    <!-- 内部布局内容 -->
</com.google.android.material.card.MaterialCardView>

从截图来看，布局存在明显的元素错位、间距异常，优先检查主题样式和组件默认属性的变更。

内容的提问来源于stack exchange，提问作者Farzan Siddiqui