MUI CSS主题变量何时引入？为何仍处于实验性状态？

引入时间 #

MUI的CSS主题变量功能是在v5.11.0版本中作为实验性特性正式推出的。

为何仍处于实验性阶段 #

目前该特性还无法无风险投入生产，核心原因包括：

• API未完全稳定：CSS变量相关的配置API（如createTheme里的cssVariablesRoot参数、主题变量的命名规则）仍在迭代，后续版本可能会出现破坏性变更，升级时需要修改大量适配代码。
• 组件支持不全面：部分MUI内置组件对CSS主题变量的适配还存在遗漏，第三方基于MUI封装的组件更是大概率未兼容该特性，使用时容易出现样式异常、主题切换失效等问题。
• 边缘场景bug未解决：在主题嵌套、高频动态主题切换、服务器端渲染（SSR）等复杂场景下，可能出现样式优先级冲突、变量注入延迟、hydration不匹配等未彻底修复的问题。
• 配套支持滞后：官方文档的细节说明、故障排查指引不够完善，ESLint插件、主题调试工具等配套工具对该特性的支持也未跟进到位，开发中遇到问题难以及时解决。

内容的提问来源于stack exchange，提问作者Alireza Garshasbi