fes.js/guide/upgrade3.html

23 lines
35 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>从 2.x 迁移到 3.x | Fes.js</title>
<meta name="description" content="一个好用的前端应用解决方案">
<link rel="preload stylesheet" href="/fes.js/assets/style.b3e1fa1b.css" as="style">
<script type="module" src="/fes.js/assets/app.0f730a80.js"></script>
<link rel="preload" href="/fes.js/assets/inter-roman-latin.2ed14f66.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="modulepreload" href="/fes.js/assets/chunks/framework.c0b2e358.js">
<link rel="modulepreload" href="/fes.js/assets/chunks/theme.a3a120a7.js">
<link rel="modulepreload" href="/fes.js/assets/guide_upgrade3.md.9dd5f317.lean.js">
<link rel="icon" href="/logo.png">
<script id="check-dark-light">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
</head>
<body>
<div id="app"><div class="Layout" data-v-c982d990><!--[--><!--]--><!--[--><span tabindex="-1" data-v-9bf6d7db></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-9bf6d7db> Skip to content </a><!--]--><!----><header class="VPNav" data-v-c982d990 data-v-ff131f89><div class="VPNavBar has-sidebar" data-v-ff131f89 data-v-ad99e568><div class="container" data-v-ad99e568><div class="title" data-v-ad99e568><div class="VPNavBarTitle has-sidebar" data-v-ad99e568 data-v-86575ca4><a class="title" href="/fes.js/" data-v-86575ca4><!--[--><!--]--><!--[--><img class="VPImage logo" src="/fes.js/logo.png" alt data-v-280cc8a9><!--]--><!--[-->Fes.js<!--]--><!--[--><!--]--></a></div></div><div class="content" data-v-ad99e568><div class="curtain" data-v-ad99e568></div><div class="content-body" data-v-ad99e568><!--[--><!--]--><div class="VPNavBarSearch search" style="--vp-meta-key:&#39;Meta&#39;;" data-v-ad99e568><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg class="DocSearch-Search-Icon" width="20" height="20" viewBox="0 0 20 20" aria-label="search icon"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-ad99e568 data-v-ecf4fece><span id="main-nav-aria-label" class="visually-hidden" data-v-ecf4fece>Main Navigation</span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/fes.js/guide/" tabindex="0" data-v-ecf4fece data-v-01ba5510 data-v-533f53c0><!--[-->指南<!--]--><!----></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/fes.js/reference/config/" tabindex="0" data-v-ecf4fece data-v-01ba5510 data-v-533f53c0><!--[-->编译时配置<!--]--><!----></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/fes.js/reference/api/" tabindex="0" data-v-ecf4fece data-v-01ba5510 data-v-533f53c0><!--[-->API<!--]--><!----></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/fes.js/reference/plugin/" tabindex="0" data-v-ecf4fece data-v-01ba5510 data-v-533f53c0><!--[-->插件<!--]--><!----></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/fes.js/reference/cli/index.html" tabindex="0" data-v-ecf4fece data-v-01ba5510 data-v-533f53c0><!--[-->CLI<!--]--><!----></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-ecf4fece data-v-82a1a585><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-82a1a585><span class="text" data-v-82a1a585><!----> v4.0.2 <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="text-icon" data-v-82a1a585><path d="M12,16c-0.3,0-0.5-0.1-0.7-0.3l-6-6c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l5.3,5.3l5.3-5.3c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-6,6C12.5,15.9,12.3,16,12,16z"></path></svg></span></button><div class="menu" data-v-82a1a585><div class="VPMenu" data-v-82a1a585 data-v-03144ce2><div class="items" data-v-03144ce2><!--[--><!--[--><div class="VPMenuLink" data-v-03144ce2 data-v-12ecb86a><a class="VPLink link" href="https://fesjs.mumblefe.cn/2.0/" target="_blank" rel="noreferrer" data-v-12ecb86a data-v-533f53c0><!--[-->v2.0<!--]--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" height="24px" viewbox="0 0 24 24" width="24px" class="icon" data-v-533f53c0><path d="M0 0h24v24H0V0z" fill="none"></path><path d="M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z"></path></svg></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-03144ce2 data-v-12ecb86a><a class="VPLink link" href="https://fesjs.mumblefe.cn/1.0/" target="_blank" rel="noreferrer" data-v-12ecb86a data-v-533f53c0><!--[-->v1.0<!--]--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" height="24px" viewbox="0 0 24 24" width="24px" class="icon" data-v-533f53c0><path d="M0 0h24v24H0V0z" fill="none"></path><path d="M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z"></path></svg></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-ecf4fece data-v-82a1a585><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-82a1a585><span class="text" data-v-82a1a585><!----> 了解更多 <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="text-icon" data-v-82a1a585><path d="M12,16c-0.3,0-0.5-0.1-0.7-0.3l-6-6c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l5.3,5.3l5.3-5.3c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-6,6C12.5,15.9,12.3,16,12,16z"></path></svg></span></button><div class="menu" data-v-82a1a585><div class="VPMenu" data-v-82a1a585 data-v-03144ce2><div class="items" data-v-03144ce2><!--[--><!--[--><div class="VPMenuLink" data-v-03144ce2 data-v-12ecb86a><a class="VPLink link" href="https://github.com/WeBankFinTech/fes.js/blob/master/CHANGELOG.md" target="_blank" rel="noreferrer" data-v-12ecb86a data-v-533f53c0><!--[-->更新日志<!--]--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" height="24px" viewbox="0 0 24 24" width="24px" class="icon" data-v-533f53c0><path d="M0 0h24v24H0V0z" fill="none"></path><path d="M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z"></path></svg></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-03144ce2 data-v-12ecb86a><a class="VPLink link" href="http://fes-design.mumblefe.cn/" target="_blank" rel="noreferrer" data-v-12ecb86a data-v-533f53c0><!--[-->fes-design<!--]--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" height="24px" viewbox="0 0 24 24" width="24px" class="icon" data-v-533f53c0><path d="M0 0h24v24H0V0z" fill="none"></path><path d="M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z"></path></svg></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-ad99e568 data-v-75582774><label title="toggle dark mode" data-v-75582774 data-v-6efb6d28><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" aria-checked="false" data-v-6efb6d28 data-v-ef40f123><span class="check" data-v-ef40f123><span class="icon" data-v-ef40f123><!--[--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="sun" data-v-6efb6d28><path d="M12,18c-3.3,0-6-2.7-6-6s2.7-6,6-6s6,2.7,6,6S15.3,18,12,18zM12,8c-2.2,0-4,1.8-4,4c0,2.2,1.8,4,4,4c2.2,0,4-1.8,4-4C16,9.8,14.2,8,12,8z"></path><path d="M12,4c-0.6,0-1-0.4-1-1V1c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,3.6,12.6,4,12,4z"></path><path d="M12,24c-0.6,0-1-0.4-1-1v-2c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,23.6,12.6,24,12,24z"></path><path d="M5.6,6.6c-0.3,0-0.5-0.1-0.7-0.3L3.5,4.9c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C6.2,6.5,5.9,6.6,5.6,6.6z"></path><path d="M19.8,20.8c-0.3,0-0.5-0.1-0.7-0.3l-1.4-1.4c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C20.3,20.7,20,20.8,19.8,20.8z"></path><path d="M3,13H1c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S3.6,13,3,13z"></path><path d="M23,13h-2c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S23.6,13,23,13z"></path><path d="M4.2,20.8c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C4.7,20.7,4.5,20.8,4.2,20.8z"></path><path d="M18.4,6.6c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C18.9,6.5,18.6,6.6,18.4,6.6z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="moon" data-v-6efb6d28><path d="M12.1,22c-0.3,0-0.6,0-0.9,0c-5.5-0.5-9.5-5.4-9-10.9c0.4-4.8,4.2-8.6,9-9c0.4,0,0.8,0.2,1,0.5c0.2,0.3,0.2,0.8-0.1,1.1c-2,2.7-1.4,6.4,1.3,8.4c2.1,1.6,5,1.6,7.1,0c0.3-0.2,0.7-0.3,1.1-0.1c0.3,0.2,0.5,0.6,0.5,1c-0.2,2.7-1.5,5.1-3.6,6.8C16.6,21.2,14.4,22,12.1,22zM9.3,4.4c-2.9,1-5,3.6-5.2,6.8c-0.4,4.4,2.8,8.3,7.2,8.7c2.1,0.2,4.2-0.4,5.8-1.8c1.1-0.9,1.9-2.1,2.4-3.4c-2.5,0.9-5.3,0.5-7.5-1.1C9.2,11.4,8.1,7.7,9.3,4.4z"></path></svg><!--]--></span></span></button></label></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-ad99e568 data-v-f51efe90 data-v-f7f7bd2d><!--[--><a class="VPSocialLink" href="https://github.com/WeBankFinTech/fes.js" aria-label="github" target="_blank" rel="noopener" data-v-f7f7bd2d data-v-ad889de2><svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>GitHub</title><path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></svg></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-ad99e568 data-v-4f9f8b99 data-v-82a1a585><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-82a1a585><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="icon" data-v-82a1a585><circle cx="12" cy="12" r="2"></circle><circle cx="19" cy="12" r="2"></circle><circle cx="5" cy="12" r="2"></circle></svg></button><div class="menu" data-v-82a1a585><div class="VPMenu" data-v-82a1a585 data-v-03144ce2><!----><!--[--><!--[--><!----><div class="group" data-v-4f9f8b99><div class="item appearance" data-v-4f9f8b99><p class="label" data-v-4f9f8b99>Appearance</p><div class="appearance-action" data-v-4f9f8b99><label title="toggle dark mode" data-v-4f9f8b99 data-v-6efb6d28><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" aria-checked="false" data-v-6efb6d28 data-v-ef40f123><span class="check" data-v-ef40f123><span class="icon" data-v-ef40f123><!--[--><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="sun" data-v-6efb6d28><path d="M12,18c-3.3,0-6-2.7-6-6s2.7-6,6-6s6,2.7,6,6S15.3,18,12,18zM12,8c-2.2,0-4,1.8-4,4c0,2.2,1.8,4,4,4c2.2,0,4-1.8,4-4C16,9.8,14.2,8,12,8z"></path><path d="M12,4c-0.6,0-1-0.4-1-1V1c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,3.6,12.6,4,12,4z"></path><path d="M12,24c-0.6,0-1-0.4-1-1v-2c0-0.6,0.4-1,1-1s1,0.4,1,1v2C13,23.6,12.6,24,12,24z"></path><path d="M5.6,6.6c-0.3,0-0.5-0.1-0.7-0.3L3.5,4.9c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C6.2,6.5,5.9,6.6,5.6,6.6z"></path><path d="M19.8,20.8c-0.3,0-0.5-0.1-0.7-0.3l-1.4-1.4c-0.4-0.4-0.4-1,0-1.4s1-0.4,1.4,0l1.4,1.4c0.4,0.4,0.4,1,0,1.4C20.3,20.7,20,20.8,19.8,20.8z"></path><path d="M3,13H1c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S3.6,13,3,13z"></path><path d="M23,13h-2c-0.6,0-1-0.4-1-1s0.4-1,1-1h2c0.6,0,1,0.4,1,1S23.6,13,23,13z"></path><path d="M4.2,20.8c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C4.7,20.7,4.5,20.8,4.2,20.8z"></path><path d="M18.4,6.6c-0.3,0-0.5-0.1-0.7-0.3c-0.4-0.4-0.4-1,0-1.4l1.4-1.4c0.4-0.4,1-0.4,1.4,0s0.4,1,0,1.4l-1.4,1.4C18.9,6.5,18.6,6.6,18.4,6.6z"></path></svg><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="moon" data-v-6efb6d28><path d="M12.1,22c-0.3,0-0.6,0-0.9,0c-5.5-0.5-9.5-5.4-9-10.9c0.4-4.8,4.2-8.6,9-9c0.4,0,0.8,0.2,1,0.5c0.2,0.3,0.2,0.8-0.1,1.1c-2,2.7-1.4,6.4,1.3,8.4c2.1,1.6,5,1.6,7.1,0c0.3-0.2,0.7-0.3,1.1-0.1c0.3,0.2,0.5,0.6,0.5,1c-0.2,2.7-1.5,5.1-3.6,6.8C16.6,21.2,14.4,22,12.1,22zM9.3,4.4c-2.9,1-5,3.6-5.2,6.8c-0.4,4.4,2.8,8.3,7.2,8.7c2.1,0.2,4.2-0.4,5.8-1.8c1.1-0.9,1.9-2.1,2.4-3.4c-2.5,0.9-5.3,0.5-7.5-1.1C9.2,11.4,8.1,7.7,9.3,4.4z"></path></svg><!--]--></span></span></button></label></div></div></div><div class="group" data-v-4f9f8b99><div class="item social-links" data-v-4f9f8b99><div class="VPSocialLinks social-links-list" data-v-4f9f8b99 data-v-f7f7bd2d><!--[--><a class="VPSocialLink" href="https://github.com/WeBankFinTech/fes.js" aria-label="github" target="_blank" rel="noopener" data-v-f7f7bd2d data-v-ad889de2><svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>GitHub</title><path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></svg></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-ad99e568 data-v-f770a2fa><span class="container" data-v-f770a2fa><span class="top" data-v-f770a2fa></span><span class="middle" data-v-f770a2fa></span><span class="bottom" data-v-f770a2fa></span></span></button></div></div></div></div><!----></header><div class="VPLocalNav" data-v-c982d990 data-v-3fcd6355><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-3fcd6355><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" viewbox="0 0 24 24" class="menu-icon" data-v-3fcd6355><path d="M17,11H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h14c0.6,0,1,0.4,1,1S17.6,11,17,11z"></path><path d="M21,7H3C2.4,7,2,6.6,2,6s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,7,21,7z"></path><path d="M21,15H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h18c0.6,0,1,0.4,1,1S21.6,15,21,15z"></path><path d="M17,19H3c-0.6,0-1-0.4-1-1s0.4-1,1-1h14c0.6,0,1,0.4,1,1S17.6,19,17,19z"></path></svg><span class="menu-text" data-v-3fcd6355>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-3fcd6355 data-v-932364f2><button data-v-932364f2>Return to top</button><!----></div></div><aside class="VPSidebar" data-v-c982d990 data-v-a33f3375><div class="curtain" data-v-a33f3375></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-a33f3375><span class="visually-hidden" id="sidebar-aria-label" data-v-a33f3375> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="group" data-v-a33f3375><section class="VPSidebarItem level-0" data-v-a33f3375 data-v-2a8297e6><div class="item" role="button" tabindex="0" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><h2 class="text" data-v-2a8297e6>开始</h2><!----></div><div class="items" data-v-2a8297e6><!--[--><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/index.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>介绍</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/getting-started.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>快速上手</p><!--]--><!----></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-a33f3375><section class="VPSidebarItem level-0 has-active" data-v-a33f3375 data-v-2a8297e6><div class="item" role="button" tabindex="0" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><h2 class="text" data-v-2a8297e6>基础</h2><!----></div><div class="items" data-v-2a8297e6><!--[--><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/directory-structure.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>目录结构</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/builder.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>Vite 和 Webpack 双构建</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/config.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>编译时配置</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/runtime-config.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>运行时配置</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/env.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>环境变量</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/route.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>路由</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/plugin.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>插件</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/template.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>HTML 模板</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/mock.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>Mock 数据</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link is-active has-active" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/upgrade3.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>从 2.x 迁移到 3.x</p><!--]--><!----></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-a33f3375><section class="VPSidebarItem level-0" data-v-a33f3375 data-v-2a8297e6><div class="item" role="button" tabindex="0" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><h2 class="text" data-v-2a8297e6>样式和资源文件</h2><!----></div><div class="items" data-v-2a8297e6><!--[--><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/image.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>使用图片</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/css.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>使用 css</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/public.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>静态资源</p><!--]--><!----></a><!----></div><!----></div><!--]--></div></section></div><div class="group" data-v-a33f3375><section class="VPSidebarItem level-0" data-v-a33f3375 data-v-2a8297e6><!----><div class="items" data-v-2a8297e6><!--[--><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/contributing.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>贡献指南</p><!--]--><!----></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-2a8297e6 data-v-2a8297e6><div class="item" data-v-2a8297e6><div class="indicator" data-v-2a8297e6></div><a class="VPLink link link" href="/fes.js/guide/faq.html" data-v-2a8297e6 data-v-533f53c0><!--[--><p class="text" data-v-2a8297e6>常见问题</p><!--]--><!----></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-c982d990 data-v-aab02ce5><div class="VPDoc has-sidebar has-aside" data-v-aab02ce5 data-v-8bcd8b54><!--[--><!--]--><div class="container" data-v-8bcd8b54><div class="aside" data-v-8bcd8b54><div class="aside-curtain" data-v-8bcd8b54></div><div class="aside-container" data-v-8bcd8b54><div class="aside-content" data-v-8bcd8b54><div class="VPDocAside" data-v-8bcd8b54 data-v-6e5c50e4><!--[--><!--]--><!--[--><!--]--><div class="VPDocAsideOutline" data-v-6e5c50e4 data-v-4dee4c11><div class="content" data-v-4dee4c11><div class="outline-marker" data-v-4dee4c11></div><div class="outline-title" data-v-4dee4c11>本页目录</div><nav aria-labelledby="doc-outline-aria-label" data-v-4dee4c11><span class="visually-hidden" id="doc-outline-aria-label" data-v-4dee4c11> Table of Contents for current page </span><ul class="root" data-v-4dee4c11 data-v-8857e549><!--[--><!--]--></ul></nav></div></div><!--[--><!--]--><div class="spacer" data-v-6e5c50e4></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-8bcd8b54><div class="content-container" data-v-8bcd8b54><!--[--><!--]--><!----><main class="main" data-v-8bcd8b54><div style="position:relative;" class="vp-doc _fes_js_guide_upgrade3" data-v-8bcd8b54><div><h1 id="从-2-x-迁移到-3-x" tabindex="-1">从 2.x 迁移到 3.x <a class="header-anchor" href="#从-2-x-迁移到-3-x" aria-label="Permalink to &quot;从 2.x 迁移到 3.x&quot;">​</a></h1><h2 id="版本-3-x-的-break" tabindex="-1">版本 3.x 的 break <a class="header-anchor" href="#版本-3-x-的-break" aria-label="Permalink to &quot;版本 3.x 的 break&quot;">​</a></h2><ol><li>环境要求 <code>node &gt;= v18.12.0</code></li><li>编译时的 <a href="./../reference/config//#base">base</a> 配置,移到了 <a href="./../reference/config//#router">router.base</a> 下</li><li><a href="https://github.com/webpack/webpack-dev-server" target="_blank" rel="noreferrer">webpack-dev-server</a> 从 <code>v3.x</code> 升级到了 <code>v5.x</code>,如果遇到配置不兼容,可以查看<a href="https://github.com/webpack/webpack-dev-server/blob/master/migration-v4.md" target="_blank" rel="noreferrer">webpack-dev-server 3.x 升级 4.x</a>、<a href="https://github.com/webpack/webpack-dev-server/blob/master/migration-v5.md" target="_blank" rel="noreferrer">webpack-dev-server 4.x 升级 5.x</a></li><li><a href="./../reference/plugin/plugins/layout.html#_4-x-升级到-5-x">layout 插件</a> 有一些属性变更</li><li><a href="./../reference/plugin/plugins/request.html#_2-x-升级到-3-x">request 插件</a> 有一些参数变更,升级请使用最新版本</li></ol><h2 id="继续使用-webpack" tabindex="-1">继续使用 Webpack <a class="header-anchor" href="#继续使用-webpack" aria-label="Permalink to &quot;继续使用 Webpack&quot;">​</a></h2><ol><li>添加 Webpack 构建依赖包: <code>npm i @fesjs/builder-webpack -D</code></li><li><code>dev</code> 的 <code>publicPath</code> 配置不能为 <code>./</code>,请更改为 <code>auto</code></li><li>将 html 模版文件从 <code>public/index.html</code> 挪到项目根目录,移除 <a href="https://github.com/jantimon/html-webpack-plugin" target="_blank" rel="noreferrer">html-webpack-plugin</a> 相关配置,具体模版变量使用请查看<a href="./../guide/template.html">HTML 模版</a></li></ol><h2 id="换成-vite" tabindex="-1">换成 Vite <a class="header-anchor" href="#换成-vite" aria-label="Permalink to &quot;换成 Vite&quot;">​</a></h2><ol><li>安装依赖包 <code>npm i @fesjs/builder-vite</code></li><li>将 Webpack 相关的配置换成 Vite,具体可查看<a href="./../reference/config/">配置</a></li><li>将 html 模版文件从 <code>public/index.html</code> 挪到项目根目录,如果有相应的 <a href="https://github.com/jantimon/html-webpack-plugin" target="_blank" rel="noreferrer">html-webpack-plugin</a> 配置,需要改成 <a href="https://github.com/vbenjs/vite-plugin-html" target="_blank" rel="noreferrer">vite-plugin-html</a> 的写法</li><li>将 <code>require</code> 等 Vite 不支持的代码,改写成 Vite 支持的方式</li></ol><h2 id="插件" tabindex="-1">插件 <a class="header-anchor" href="#插件" aria-label="Permalink to &quot;插件&quot;">​</a></h2><p>插件都需要升级到 <code>3.x</code> 版本,新版添加了兼容<code>builder</code>的逻辑,但是提供的接口和配置没有变化,只需要升级版本即可使用。</p><ul><li><a href="./../reference/plugin/plugins/layout.html">@fesjs/plugin-layout</a> 需要升级到<code>5.0.x</code>版本。</li><li><a href="./../reference/plugin/plugins/locale.html">@fesjs/plugin-locale</a> 需要升级到<code>4.0.x</code>版本。</li><li><a href="./../reference/plugin/plugins/qiankun.html">@fesjs/plugin-qiankun</a> 由于<code>qiankun</code>技术限制,子应用目前还只能使用 Webpack 构建。</li></ul></div></div></main><footer class="VPDocFooter" data-v-8bcd8b54 data-v-e1b9dc35><!--[--><!--]--><!----><div class="prev-next" data-v-e1b9dc35><div class="pager" data-v-e1b9dc35><a class="pager-link prev" href="/fes.js/guide/mock.html" data-v-e1b9dc35><span class="desc" data-v-e1b9dc35>Previous page</span><span class="title" data-v-e1b9dc35>Mock 数据</span></a></div><div class="has-prev pager" data-v-e1b9dc35><a class="pager-link next" href="/fes.js/guide/image.html" data-v-e1b9dc35><span class="desc" data-v-e1b9dc35>Next page</span><span class="title" data-v-e1b9dc35>使用图片</span></a></div></div></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-c982d990 data-v-1e62c1ee><div class="container" data-v-1e62c1ee><p class="message" data-v-1e62c1ee>Released under the MIT License.</p><p class="copyright" data-v-1e62c1ee>Copyright © 2020-present Webank</p></div></footer><!--[--><!--]--></div></div>
<script>__VP_HASH_MAP__ = JSON.parse("{\"guide_image.md\":\"36746bb2\",\"guide_index.md\":\"7dfc3871\",\"guide_builder.md\":\"c6cb11a8\",\"guide_plugin.md\":\"e6295e64\",\"guide_getting-started.md\":\"0f694b86\",\"index.md\":\"44d97509\",\"reference_cli_index.md\":\"790bfebb\",\"reference_api.md\":\"812a4a62\",\"reference_api_index.md\":\"855014bf\",\"guide_directory-structure.md\":\"5f8a75fc\",\"reference_config_index.md\":\"3a344840\",\"guide_css.md\":\"5718fde2\",\"guide_route.md\":\"5faea7de\",\"guide_contributing.md\":\"23f4e555\",\"guide_upgrade4.md\":\"71437897\",\"guide_faq.md\":\"cb43349e\",\"guide_upgrade3.md\":\"9dd5f317\",\"guide_runtime-config.md\":\"d227f992\",\"guide_public.md\":\"4b5013b0\",\"guide_template.md\":\"28d9a9cc\",\"guide_mock.md\":\"54017269\",\"guide_env.md\":\"1b6193c3\",\"guide_config.md\":\"90075696\",\"reference_plugin_index.md\":\"239bc1cb\",\"reference_plugin_dev_index.md\":\"ba805268\",\"reference_plugin_plugins_icon.md\":\"ffb70ab6\",\"reference_plugin_plugins_login.md\":\"d495e141\",\"reference_plugin_plugins_access.md\":\"f419fc82\",\"reference_plugin_plugins_model.md\":\"5050d2db\",\"reference_plugin_plugins_request-4.md\":\"270a4a39\",\"reference_plugin_plugins_watermark.md\":\"125909af\",\"reference_plugin_plugins_vuex.md\":\"9c6abfc9\",\"reference_plugin_plugins_qiankun.md\":\"e62ecf75\",\"reference_plugin_dev_api.md\":\"78fd7e31\",\"reference_plugin_plugins_windicss.md\":\"33fee377\",\"reference_plugin_plugins_jest.md\":\"2ebeee69\",\"reference_plugin_plugins_swc.md\":\"dbaf6006\",\"reference_plugin_plugins_sass.md\":\"f5b8bd63\",\"reference_plugin_plugins_layout.md\":\"8206e714\",\"reference_plugin_plugins_request.md\":\"2d16bf3c\",\"reference_plugin_plugins_pinia.md\":\"3b2e75b3\",\"reference_plugin_plugins_enums.md\":\"385ba3a6\",\"reference_plugin_plugins_editor.md\":\"032542be\",\"reference_plugin_plugins_locale.md\":\"3060b8da\"}")
__VP_SITE_DATA__ = JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Fes.js\",\"description\":\"一个好用的前端应用解决方案\",\"base\":\"/fes.js/\",\"head\":[],\"appearance\":true,\"themeConfig\":{\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/WeBankFinTech/fes.js\"}],\"logo\":\"/logo.png\",\"nav\":[{\"text\":\"指南\",\"link\":\"/guide/\",\"activeMatch\":\"/guide/\"},{\"text\":\"编译时配置\",\"link\":\"/reference/config/\"},{\"text\":\"API\",\"link\":\"/reference/api/\"},{\"text\":\"插件\",\"link\":\"/reference/plugin/\",\"activeMatch\":\"/plugin/\"},{\"text\":\"CLI\",\"link\":\"/reference/cli/index.md\"},{\"text\":\"v4.0.2\",\"items\":[{\"text\":\"v2.0\",\"link\":\"https://fesjs.mumblefe.cn/2.0/\"},{\"text\":\"v1.0\",\"link\":\"https://fesjs.mumblefe.cn/1.0/\"}]},{\"text\":\"了解更多\",\"items\":[{\"text\":\"更新日志\",\"link\":\"https://github.com/WeBankFinTech/fes.js/blob/master/CHANGELOG.md\"},{\"text\":\"fes-design\",\"link\":\"http://fes-design.mumblefe.cn/\"}]}],\"sidebar\":{\"/guide/\":[{\"text\":\"开始\",\"items\":[{\"text\":\"介绍\",\"link\":\"/guide/index.md\"},{\"text\":\"快速上手\",\"link\":\"/guide/getting-started.md\"}]},{\"text\":\"基础\",\"items\":[{\"text\":\"目录结构\",\"link\":\"/guide/directory-structure.md\"},{\"text\":\"Vite 和 Webpack 双构建\",\"link\":\"/guide/builder.md\"},{\"text\":\"编译时配置\",\"link\":\"/guide/config.md\"},{\"text\":\"运行时配置\",\"link\":\"/guide/runtime-config.md\"},{\"text\":\"环境变量\",\"link\":\"/guide/env.md\"},{\"text\":\"路由\",\"link\":\"/guide/route.md\"},{\"text\":\"插件\",\"link\":\"/guide/plugin.md\"},{\"text\":\"HTML 模板\",\"link\":\"/guide/template.md\"},{\"text\":\"Mock 数据\",\"link\":\"/guide/mock.md\"},{\"text\":\"从 2.x 迁移到 3.x\",\"link\":\"/guide/upgrade3.md\"}]},{\"text\":\"样式和资源文件\",\"items\":[{\"text\":\"使用图片\",\"link\":\"/guide/image.md\"},{\"text\":\"使用 css\",\"link\":\"/guide/css.md\"},{\"text\":\"静态资源\",\"link\":\"/guide/public.md\"}]},{\"text\":\"贡献指南\",\"link\":\"/guide/contributing.md\"},{\"text\":\"常见问题\",\"link\":\"/guide/faq.md\"}],\"/reference/plugin/\":[{\"text\":\"介绍\",\"link\":\"/reference/plugin/index.md\"},{\"text\":\"Plugins\",\"items\":[{\"text\":\"@fesjs/plugin-access\",\"link\":\"/reference/plugin/plugins/access.md\"},{\"text\":\"@fesjs/plugin-enums\",\"link\":\"/reference/plugin/plugins/enums.md\"},{\"text\":\"@fesjs/plugin-icon\",\"link\":\"/reference/plugin/plugins/icon.md\"},{\"text\":\"@fesjs/plugin-jest\",\"link\":\"/reference/plugin/plugins/jest.md\"},{\"text\":\"@fesjs/plugin-layout\",\"link\":\"/reference/plugin/plugins/layout.md\"},{\"text\":\"@fesjs/plugin-locale\",\"link\":\"/reference/plugin/plugins/locale.md\"},{\"text\":\"@fesjs/plugin-model\",\"link\":\"/reference/plugin/plugins/model.md\"},{\"text\":\"@fesjs/plugin-request\",\"link\":\"/reference/plugin/plugins/request.md\"},{\"text\":\"@fesjs/plugin-vuex\",\"link\":\"/reference/plugin/plugins/vuex.md\"},{\"text\":\"@fesjs/plugin-qiankun\",\"link\":\"/reference/plugin/plugins/qiankun.md\"},{\"text\":\"@fesjs/plugin-windicss\",\"link\":\"/reference/plugin/plugins/windicss.md\"},{\"text\":\"@fesjs/plugin-sass\",\"link\":\"/reference/plugin/plugins/sass.md\"},{\"text\":\"@fesjs/plugin-editor\",\"link\":\"/reference/plugin/plugins/editor.md\"},{\"text\":\"@fesjs/plugin-pinia\",\"link\":\"/reference/plugin/plugins/pinia.md\"},{\"text\":\"@fesjs/plugin-watermark\",\"link\":\"/reference/plugin/plugins/watermark.md\"},{\"text\":\"@fesjs/plugin-login\",\"link\":\"/reference/plugin/plugins/login.md\"},{\"text\":\"@fesjs/plugin-swc\",\"link\":\"/reference/plugin/plugins/swc.md\"}]},{\"text\":\"插件开发\",\"items\":[{\"text\":\"插件介绍\",\"link\":\"/reference/plugin/dev/index.md\"},{\"text\":\"插件API\",\"link\":\"/reference/plugin/dev/api.md\"}]}]},\"outline\":{\"label\":\"本页目录\"},\"search\":{\"provider\":\"local\"},\"footer\":{\"message\":\"Released under the MIT License.\",\"copyright\":\"Copyright © 2020-present Webank\"}},\"locales\":{},\"scrollOffset\":90,\"cleanUrls\":false}")</script>
</body>
</html>