部署、上线与维护

部署不是最后一步的“上传代码”，而是验证项目能否离开你的电脑正常运行。

部署前先判断项目类型

项目类型	推荐部署方式
纯 HTML/CSS/JS	GitHub Pages、Netlify、Cloudflare Pages
Vite/React 前端	Vercel、Netlify、Cloudflare Pages
VitePress 文档站	Vercel、Netlify、Cloudflare Pages
有后端 API	Vercel Functions、Render、Railway、Fly.io
有数据库	Supabase、Neon、PlanetScale、托管 PostgreSQL

不要把所有项目都按全栈部署处理。项目越简单，部署越稳定。

本地能跑不等于线上能跑

线上环境常见差异：

• Node 版本不同；
• 环境变量缺失；
• 构建输出目录配置错误；
• API 地址写死为 localhost；
• 大小写路径在本地不报错，线上报错；
• 静态资源路径不正确。

部署前检查

• npm run build 能通过；
• 输出目录明确；
• 环境变量齐全；
• 没有提交 .env；
• 关键页面可访问；
• 控制台没有明显错误；
• 有回滚方式。

推荐入口

• 静态站点部署
• Vite 应用部署
• 环境变量基础
• 域名与 HTTPS
• README 和项目文档
• 项目维护

小结

部署的核心是“可重复”。只要构建命令、输出目录、环境变量和回滚方案清楚，项目上线就不会完全靠运气。