Webpack Aliases 已移除
页面摘要: Strapi v5 移除了大多数 webpack 别名以获得更好的兼容性,仅保留
react、react-dom、react-router-dom和styled-components等必要依赖的别名。
在 Strapi v5 中,移除了 webpack 别名,以确保更好的兼容性并减少依赖冲突。
本页面是破坏性变更数据库的一部分,提供有关该破坏性变更的信息,以及从 Strapi v4 迁移到 Strapi 5 的附加说明。
破坏性变更说明
在 Strapi v4 中
Strapi 维护着一份在 webpack 配置中被设置别名的特定依赖列表。这确保了插件始终使用 Strapi 版本的某些库,如设计系统。
在 Strapi 5 中
别名流程被简化。只有 react、react-dom、react-router-dom 和 styled-components 等必要依赖被设置别名。
迁移
本节汇总了关于该破坏性变更的有用说明和操作步骤。
说明
-
如果你遇到第三方插件的问题,建议你在相应插件的仓库中提交 issue。鼓励插件维护者将他们的依赖添加到其
package.json文件中以解决兼容性问题。 -
如果你遇到本地插件的问题,可以通过修改所选打包工具中的
resolve选项来修复。
手动操作步骤
要迁移到 Strapi 5:
- 找出任何引用了 Strapi v4 中现已移除的 Webpack 别名的配置文件(例如 webpack 配置)。
- 确保代码中任何对 Webpack 别名的引用都被替换为适当的导入或路径。
- 如果项目中使用了第三方插件,请验证它们不依赖于 Strapi v5 中不再存在的 Webpack 别名。
- 如有必要,与插件作者沟通,让其相应地更新依赖或配置。