首次页面加载正常,但是当通过页面点击切换路由的时候白屏,无法正常渲染子页面
Vue Transition + KeepAlive 空白页 bug**: `<Transition mode="out-in">` + 条件渲染会导致路由切换空白页。`mode="out-in"` 要求旧元素完成 leave 动画后新元素才进入,但路由切换时条件渲染可能在动画前就移除了旧元素,导致 `<Transition>` 永远等待一个不存在的元素 → 死锁。**解决方案**: 移除 `mode="out-in"`(保留 Transition 动画),或在 `apps/web-antd/src/preferences.ts` 设置 `transition: { enable: false }` 关闭动画走 `v-else` 分支。
Introduction
Vue Vben Admin is a free and open source middle and back-end template. Using the latest vue3, vite, TypeScript and other mainstream technology development, the out-of-the-box middle and back-end front-end solutions can also be used for learning reference.
Upgrade Notice
This is the latest version, 5.0, and it is not compatible with previous versions. If you are starting a new project, it is recommended to use the latest version. If you wish to view the old version, please use the v2 branch.
Features
- Latest Technology Stack: Developed with cutting-edge front-end technologies like Vue 3 and Vite
- TypeScript: A language for application-scale JavaScript
- Themes: Multiple theme colors available with customizable options
- Internationalization: Comprehensive built-in internationalization support
- Permissions: Built-in solution for dynamic route-based permission generation
Preview
- Vben Admin - Full version Chinese site
Test Account: vben/123456
Use Gitpod
Open the project in Gitpod (free online dev environment for GitHub) and start coding immediately.
Documentation
Install and Use
- Get the project code
git clone https://github.com/vbenjs/vue-vben-admin.git
- Install dependencies
cd vue-vben-admin
npm i -g corepack
pnpm install
- Run
pnpm dev
- Build
pnpm build
Change Log
How to Contribute
You are very welcome to join! Raise an issue or submit a Pull Request.
Pull Request Process:
- Fork the code
- Create your branch:
git checkout -b feat/xxxx - Submit your changes:
git commit -am 'feat(function): add xxxxx' - Push your branch:
git push origin feat/xxxx - Submit
pull request
Git Contribution Submission Specification
Reference vue specification (Angular)
featAdd new featuresfixFix the problem/BUGstyleThe code style is related and does not affect the running resultperfOptimization/performance improvementrefactorRefactorrevertUndo edittestTest relateddocsDocumentation/noteschoreDependency update/scaffolding configuration modification etc.ciContinuous integrationtypesType definition file changes
Browser Support
Tailwind CSS v4.0 is designed for Safari 16.4+, Chrome 111+, and Firefox 128+
Support modern browsers, not IE
![]() Edge |
![]() Firefox |
![]() Chrome |
![]() Safari |
|---|---|---|---|
| last 2 versions | last 2 versions | last 2 versions | last 2 versions |
Maintainer
Star History
Donate
If you think this project is helpful to you, you can help the author buy a cup of coffee to show your support!







