Vue 3 项目部署到服务器的详细指南,涵盖常见场景、问题及解决方案
以下是 Vue 3 项目部署到服务器的详细指南,涵盖常见场景、问题及解决方案,综合了多个最佳实践和官方推荐配置:
一、部署步骤与服务器环境要求
-
环境准备
- Node.js 和 npm/yarn:用于项目依赖管理和构建,建议安装 LTS 版本。
- 构建工具:Vue CLI 或 Vite 默认集成 Webpack/Rollup,无需额外安装。
- Web 服务器:推荐 Nginx(高性能静态资源托管)或 Apache。
-
项目构建
- 运行
npm run build
生成dist
目录,包含优化后的静态文件。 - 配置调整:若部署到子目录(如
/demo
),需在vite.config.ts
或vue.config.js
中设置base: '/demo/'
,并在路由中同步配置createWebHistory(import.meta.env.BASE_URL)
。
- 运行
-
服务器部署
- 上传文件:将
dist
目录内容上传至服务器(如/var/www/html
- 上传文件:将