import{_ as e,o as a,c as r,V as l}from"./chunks/framework.b31a4d00.js";const f=JSON.parse('{"title":"从 2.x 迁移到 3.x","description":"","frontmatter":{},"headers":[],"relativePath":"guide/upgrade3.md"}'),t={name:"guide/upgrade3.md"},i=l('

从 2.x 迁移到 3.x ​

版本 3.x 的 break ​

  1. 环境要求 node >= v18.12.0
  2. 编译时的 base 配置，移到了 router.base 下
  3. webpack-dev-server 从 v3.x 升级到了 v5.x，如果遇到配置不兼容，可以查看webpack-dev-server 3.x 升级 4.x、webpack-dev-server 4.x 升级 5.x
  4. layout 插件 有一些属性变更
  5. request 插件 有一些参数变更，升级请使用最新版本

继续使用 Webpack ​

  1. 添加 Webpack 构建依赖包： npm i @fesjs/builder-webpack -D
  2. dev 的 publicPath 配置不能为 ./，请更改为 auto
  3. 将 html 模版文件从 public/index.html 挪到项目根目录，移除 html-webpack-plugin 相关配置，具体模版变量使用请查看HTML 模版

换成 Vite ​

  1. 安装依赖包 npm i @fesjs/builder-vite
  2. 将 Webpack 相关的配置换成 Vite，具体可查看配置
  3. 将 html 模版文件从 public/index.html 挪到项目根目录，如果有相应的 html-webpack-plugin 配置，需要改成 vite-plugin-html 的写法
  4. 将 require 等 Vite 不支持的代码，改写成 Vite 支持的方式

插件 ​

插件都需要升级到 3.x 版本，新版添加了兼容builder的逻辑，但是提供的接口和配置没有变化，只需要升级版本即可使用。

',10),o=[i];function c(n,d,h,p,u,s){return a(),r("div",null,o)}const m=e(t,[["render",c]]);export{f as __pageData,m as default};