semi-design/content/start/faq/index.md

---

category: 开始 title: FAQ 常见问题 icon: doc-faq localeCode: zh-CN

order: 7

关于发版时间

• Semi 团队每双周周五进行 minor 正式版发包，中间的周五会发布一次 minor beta 版

各版本之间的关系

• Semi 版本号遵循Semver规范（主版本号-次版本号-修订版本号），我们会在minor版本新增feature或组件，在patch版本我们仅会进行bug修复，而不会做新功能更新。
• 2.x 各版本之间（即major版本号相同时），API 会保持向前兼容，但不同minor版本之间可能存在样式上的调整，当你需要升级时，我们推荐你在changelog页面使用版本Diff功能，检查所有变更并确实是否对你的业务系统有影响。

Semi是否支持Tree Shaking

• Semi执行发包时，发布的其实是esModule源码，因此天然支持tree shaking，不需要再进行额外的配置。
  • 组件的 Scss 也是由组件的index.(j|t)sx负责import的，因此样式也会shaking。简单来说，只有你使用的组件会被打包

为什么 defaultValue、defaultXXX 不起作用？

Semi 组件中，所有的 defaultValue、defaultXXX 传参只会在组件被 mounted 时进行消费（即仅消费一次）。如果你的 defaultXXX 属性是后期进行异步更新的，组件不会重新进行消费该值。如有需要，你应该使用受控的 value，受控的 xxx。 或者直接通过传入一个不一样的key值，强制 React 重新挂载该组件。

安装新版本 Semi 后，提示 can't resolve date-fns/esm/_libs/cloneObject.js 或其他有 date-fns 相关的依赖错误

检查下项目中的 package-lock.json，是否有其他包依赖了 date-fns（大概率是 1.x 的），导致 semi 依赖声明的 date-fns 2.x 没有被安装上。手动 install date-fns，确保是 2.x 版本的即可 npm install date-fns date-fns-tz

Semi 支持 i18n 吗？

Semi 目前支持 14 种语言，具体使用可以查阅 Semi·LocaleProvider

Semi 的样式是基于 Scss 还是 Less ？为什么不用 CSS Module？

我们的样式基于 Scss，与此我们还使用了 CSS Variable 作为色盘变量。色盘变量和通用变量挂载在 body 下。 不使用 CSS Module 是因为我们希望有固定的 className，为业务方保留修改/覆盖 Semi 样式的能力（虽然不提倡，但有些业务场景下确实需要）

Semi 的默认的主题风格跟我们系统的定位不符，可以配置另外的主题吗？

具体请参考 定制主题 。在我们的 主题管理平台 里可以进行样式的配置，你只需要在 webpack.config.js 里指定使用的主题包名即可完成接入（需接入 Semi 插件）。

为什么 Tooltip、Typography 不默认配置 word-break 样式？

不同语言内容（纯英文、中文、中英文混合）对 word-break 的需求不太一致，所以组件层没有做这个预设。可以根据需求，使用 CSS 进行设置。

有新组件需求、或者现有组件 Feature 不能满足我的业务需求，该找谁？

右上角问题反馈，提交 Issue，描述你的需求以及业务场景，Label 选择 Feature Request / New Component Request

对组件的使用有疑惑？不知道有没有能满足你业务需求场景的组件？

欢迎进我们的 客服飞书 Lark 群 进行咨询提问。

希望自定义滚动条的样式？

可以使用 .semi-light-scrollbar 类名，会对 webkit (chrome/safari) 的浏览器应用 Semi 的滚动条样式。该类名放在最外层的DOM元素即可，会对所有子元素生效。注：使用了通配符，可能会对性能有影响。其他浏览器可以参考是否有相关的css属性支持滚动条的样式定制。

更多的FAQ

请查阅 https://bytedance.feishu.cn/docs/doccnMRDbkhde6p3dMokfFpcNug