服务器部署
dist文件夹就是你项目的“最终成品”接下来只需要把它放到一个能让用户访问到的服务器上就行。这整个过程我们一般称之为“部署”。怎么做主要看你的项目类型和需求主要有下面这几种方式 方案一本地快速预览 (上线前自测)在把项目交给别人之前可以先在本地预览一下确保打包后的效果和开发时一样。在你的项目根目录下运行npx serve dist或者如果你用的是 Vitepnpm run preview执行后终端会显示一个本地地址比如http://localhost:5000在浏览器打开它就能预览了。️ 方案二部署到自己的服务器 (最通用)这是最常用的方式你需要一台属于自己的云服务器。核心操作就是把dist文件夹里的所有内容上传到你服务器上的某个目录里。1. 上传文件你可以用任何你喜欢的方式把文件传上去比如SCP命令在本地终端执行scp -r ./dist/* root你的服务器IP:/var/www/my-project/FTP/SFTP工具比如 FileZilla通过图形界面拖拽上传。云服务商控制台很多云服务器商都提供在线的文件管理功能。2. 配置 Web 服务器 (以 Nginx 为例)文件传上去了但还需要一个“管家”来接待访客。这个管家就是Nginx。在服务器的 Nginx 配置文件通常在/etc/nginx/sites-available/default或/etc/nginx/nginx.conf中你需要配置一个server块。一个最基础的配置如下server { listen 80; server_name your-domain.com; # 换成你的域名或服务器IP location / { # root 后面换成你上传文件的实际路径 root /var/www/my-project; try_files $uri $uri/ /index.html; # 解决刷新404问题 } }特别注意如果你的 Vue 项目使用了history模式的路由try_files $uri $uri/ /index.html;这行配置至关重要它能确保刷新页面时不会出现 404。保存配置后重启 Nginx 让配置生效sudo systemctl reload nginx现在在浏览器访问你的域名或 IP就能看到项目了。☁️ 方案三部署到云存储 (更简单、便宜)如果你不想自己管理服务器可以试试“对象存储”服务比如阿里云 OSS、腾讯云 COS。它们专门用来存放静态文件。操作在云服务商的控制台创建一个“存储桶”然后把dist文件夹里的所有文件上传进去。访问上传后服务商会自动给你生成一个访问域名打开就能看到网站。优点价格便宜并且默认就带了 CDN 加速访问速度会很快。✨ 方案四一键部署到托管平台 (最省心)如果你的项目是个人博客、作品集或开源项目文档这些平台是绝佳选择很多都提供免费套餐。Vercel / Netlify: 这两个平台非常流行你只需要把项目代码仓库 (GitHub, GitLab等) 授权给它们它们就能自动完成pnpm build并部署。以后你每次把代码推送到仓库网站都会自动更新。GitHub Pages / Gitee Pages: 这是代码托管平台自带的静态页面服务。你需要把dist文件夹的内容放到一个特定分支如gh-pages或者在仓库设置里开启 Actions 自动部署。 总结与注意事项关于base路径如果你的项目不是部署在域名根目录比如是https://域名/my-app/那么需要在vite.config.ts里设置base: /my-app/。关于环境变量打包时Vite 会读取.env.production文件里的变量。记得检查里面的VITE_API_BASE_URL等配置是否指向了正确的线上地址。关于缓存你的dist里的文件尤其是 JS 和 CSS都带了哈希值如index.a1b2c3.js。你可以放心地开启服务器的强缓存因为文件内容变化时文件名也会变从而保证用户能及时获取到最新版本。你可以根据自己的需求和预算从上面选一条路试试看。如果想深入了解某个具体方案可以随时再问我