如何在Android Studio中批量禁用Jetpack Compose预览

Android Studio提供了多套可落地的配置方案，你可以根据使用场景选择：

IDE全局配置（本地开发场景） #

• 打开设置面板：Windows/Linux使用快捷键Ctrl+Alt+S，macOS使用快捷键Cmd+,
• 搜索Compose Preview找到对应设置项，取消勾选Enable Compose Preview，应用设置后重启IDE，即可全局关闭所有Compose预览功能，所有被@Preview注解标记的方法不会再触发预览渲染、也不会生成对应的预览编译任务。
• 如果不需要完全禁用、只是想关闭预览自动渲染减少IDE卡顿，可以进入Editor > Live Edit > Compose设置页，取消勾选Automatically render previews when editing，修改代码后不会自动刷新预览，只有手动点击预览面板的渲染按钮才会加载预览。

Gradle全局配置（CI/打包场景，彻底排除预览相关依赖） #

如果需要在构建流程中彻底屏蔽预览带来的额外编译开销，可以在项目根目录的构建脚本中添加配置，全局排除所有子模块的Compose预览依赖。
Groovy语法（build.gradle）配置如下：

subprojects {
    configurations.configureEach {
        exclude group: 'androidx.compose.ui', module: 'ui-tooling'
        exclude group: 'androidx.compose.ui', module: 'ui-tooling-preview'
    }
}

KTS语法（build.gradle.kts）配置如下：

subprojects {
    configurations.configureEach {
        exclude(group = "androidx.compose.ui", module = "ui-tooling")
        exclude(group = "androidx.compose.ui", module = "ui-tooling-preview")
    }
}

添加后同步Gradle，所有预览相关的依赖会被全局移除，预览功能自然无法运行。本地开发需要恢复预览时，注释掉这段配置重新同步即可。

临时快速关闭（无需修改配置） #

如果只是临时不想看到预览面板，直接点击Compose预览面板右上角的关闭按钮即可，Android Studio会记住面板状态，后续打开带Compose代码的文件时不会自动弹出预览面板。

注意：完全禁用Compose预览后，如果后续需要恢复使用，只要重新勾选设置里的Enable Compose Preview选项、恢复Gradle依赖配置，重启IDE/同步Gradle即可正常使用。

内容的提问来源于stack exchange，提问作者Maiko Trindade