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 别名。
  • 如有必要,与插件作者沟通,让其相应地更新依赖或配置。