尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

vue-cms 打包部署终极指南:多环境发布与 deploy.sh 脚本全解析

vue-cms 打包部署终极指南:多环境发布与 deploy.sh 脚本全解析 vue-cms 打包部署终极指南多环境发布与 deploy.sh 脚本全解析【免费下载链接】vue-cms基于 Vue 和 ElementUI 构建的一个企业级后台管理系统项目地址: https://gitcode.com/gh_mirrors/vu/vue-cmsvue-cms 是一个基于 Vue 2 和 ElementUI 构建的企业级后台管理系统内置国际化、权限验证、动态路由、ECharts 可视化等丰富功能。对于很多刚接触前端项目上线的新手来说怎么把项目真正跑起来、部署到服务器上往往是最头疼的一环。这篇文章就以 vue-cms 为例带你从零掌握 Vue 项目的打包部署全流程包括本地构建、多环境配置、Nginx 发布以及项目自带的deploy.sh自动化发布脚本的逐行解析让你一次搞定前端部署。打包前必看项目目录与构建脚本速览动手打包之前先花 1 分钟熟悉 vue-cms 的工程结构后续所有命令都与它相关package.json定义项目的 npm 脚本与依赖版本vue.config.jsVue CLI 核心配置publicPath、输出目录、分包优化deploy.sh一键构建 推送 GitHub Pages 的自动化脚本.env、.env.development、.env.production多环境变量文件其中package.json里已经预置好了常用脚本比如npm run serve本地开发、npm run build生产构建、npm run lint代码检查这些都是 Vue 项目部署的基础设施。一键安装依赖最快的项目启动方法首次拿到项目先安装依赖。vue-cms 的依赖较多ElementUI、ECharts、xlsx 等推荐使用国内镜像加速npm install --registryhttps://registry.npmmirror.com/安装完成后运行npm run serve即可在本地以热更新模式启动开发服务器默认端口是 8888由 vue.config.js 中的const port process.env.PORT || 8888决定浏览器访问http://localhost:8888就能看到系统界面。多环境发布开发与生产的接口自动切换vue-cms 通过环境变量文件实现多环境发布这是企业级项目部署的核心技巧。三份文件分工明确.env所有环境都会加载存放通用配置如 Cookie Key.env.development仅开发环境加载VUE_APP_BASE_API /dev-api配合代理转发到本地 Mock 服务.env.production仅生产构建时加载VUE_APP_BASE_API /prod-api只有以VUE_APP_开头的变量才会被 Webpack 静态嵌入到前端代码中。在 src/utils/request.js 里axios 实例就是通过baseURL: process.env.VUE_APP_BASE_API读取接口前缀从而做到开发环境走 Mock、生产环境走真实接口的无缝切换。生产构建一条命令产出 dist 静态文件执行生产打包npm run build命令会调用vue-cli-service build按照 vue.config.js 的配置生成dist目录publicPath: ./使用相对路径方便部署到任意子目录或 CDNoutputDir: dist、assetsDir: static静态资源统一存放productionSourceMap: false关闭 sourceMap显著加快构建速度splitChunks分包把element-ui、第三方库、公共组件分别拆成独立 chunk提升首屏加载性能构建完成后dist目录就是可以直接扔到服务器上的完整静态站点。Nginx 部署让 vue-cms 跑在服务器上拿到dist目录后最常用的方式是交给 Nginx。一个典型配置如下server { listen 80; server_name your-domain.com; root /var/www/vue-cms/dist; index index.html; location / { try_files $uri $uri/ /index.html; } location /prod-api/ { proxy_pass http://your-backend-server/; proxy_set_header Host $host; } }关键点有两个一是try_files将未知路由回退到index.html解决前端路由刷新 404 的问题二是把/prod-api/反向代理到后端服务实现前后端联调。最后执行nginx -s reload即可生效。deploy.sh 脚本全解析一键自动化发布如果你想把 vue-cms 发布到 GitHub Pages项目自带的 deploy.sh 脚本就是现成的自动化方案。逐行拆解如下set -e任何命令出错立即终止避免带病发布npm run build先生成生产环境静态文件cd dist进入打包产物目录git initgit add -Agit commit把 dist 目录初始化为一个独立 Git 仓库git push -f ... master:gh-pages强制推送到gh-pages分支触发 GitHub Pages 自动托管使用方式很简单在项目根目录执行bash ./deploy.sh脚本里还预留了两种发布目标的注释模板发布到用户名.github.io主站、或通过 access_token 实现 CI 自动部署按需取消注释即可。常见打包部署问题排查清单最后附上一份高频问题清单遇到报错对照检查安装依赖报错优先用npm install --registryhttps://registry.npmmirror.com/不要用 cnpm构建后图片/路由 404检查 vue.config.js 中的publicPath是否为./刷新页面 404Nginx 缺少try_files回退配置接口请求不到数据确认.env.production中的VUE_APP_BASE_API与后端代理路径一致GitHub Pages 不更新确认gh-pages分支已成功推送并等待 1-2 分钟生效至此从本地开发、多环境配置、生产构建到脚本自动化发布你已经完整掌握了 vue-cms 的打包部署链路。企业级后台管理系统上线其实就这么简单。【免费下载链接】vue-cms基于 Vue 和 ElementUI 构建的一个企业级后台管理系统项目地址: https://gitcode.com/gh_mirrors/vu/vue-cms创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表