第一次把 AI 项目部署上线：从本地页面到公网链接
训练营里，很多同学第一次看到本地页面时非常兴奋。但只有自己电脑能访问，仍然无法让客户评审、让同学协作，也无法暴露真实部署环境的问题。
这份练习用 Git 驱动的托管平台完成第一次上线。课程当时使用 EdgeOne Pages；腾讯云当前已经将产品升级为 EdgeOne Makers，控制台名称和能力可能变化，实际操作以当前官方界面为准。
前置条件
- 项目在本地可以完整构建，而不只是开发模式能启动。
- 代码已经提交到 GitHub、Gitee 或平台支持的仓库。
- 所有密钥通过环境变量读取，没有写进仓库。
- 明确项目的构建命令、输出目录和 Node 版本。
- 第一轮只部署不依赖复杂后端的页面，先验证最小链路。
第一步：本地做生产构建
在连接托管平台前，先在干净环境运行项目构建命令，例如：
pnpm install --frozen-lockfile
pnpm build如果本地生产构建失败，远端大概率也会失败。先处理类型错误、缺失依赖和环境变量，不要把平台当作调试器。
成功标准
- 依赖可以从锁文件稳定安装。
- 构建命令退出码为 0。
- 构建产物能够本地预览。
第二步：推送到远程仓库
确认 Git 状态只包含本次部署需要的文件，再提交和推送：
git status
git add <本次文件>
git commit -m "feat: prepare first deployment"
git push不要把 .env、数据库密码和临时构建目录提交进去。
第三步：在托管平台导入项目
在 EdgeOne Makers 或其他托管平台创建项目，授权读取仓库，选择要部署的分支。平台通常会自动识别框架；识别错误时手动填写：
- 安装命令。
- 构建命令。
- 输出目录。
- Node 版本。
- 必要环境变量。
当前 EdgeOne Makers 官方流程支持导入 Git 仓库，自动构建并生成线上 URL；生产分支后续提交也可以触发重新部署。
第四步：阅读构建日志
部署失败时不要重复点击。日志通常已经给出问题层级：
- 依赖安装失败：包管理器、锁文件或网络问题。
- 构建命令不存在：项目配置不一致。
- 类型或编译失败：本地没有执行同样的生产构建。
- 环境变量缺失：远端没有配置本地 .env 中的值。
- 输出目录错误：平台找不到构建产物。
把具体错误行交给 AI 分析，比输入“部署失败了”有效得多。
第五步：验证公网真实流程
拿到 URL 后至少检查：
- 无登录状态下可以打开首页。
- 刷新二级路由不会出现 404。
- 静态资源和图片正常加载。
- 移动端没有明显溢出。
- 核心按钮和表单能够工作。
- 浏览器控制台没有持续错误。
- 不同网络或无痕窗口也能访问。
如果涉及后端，再验证 API 地址、跨域、HTTPS 和生产数据库。不要因为首页出现就宣布项目上线完成。
自定义域名与正式上线
平台提供的默认 URL 适合课程展示和快速评审。正式产品还要考虑自定义域名、HTTPS、备案要求、日志、监控、数据备份和回滚策略。
课程项目可以先完成可访问的最小上线，再逐步补齐生产要求；不要把临时预览链接描述成已经具备完整生产保障。
常见问题与处理
本地能跑，远端构建失败
检查是否只运行过开发模式，Node 版本是否一致，依赖是否写入 package.json，文件名大小写是否在不同系统中暴露问题。
页面打开但接口失败
确认前端没有仍指向 localhost；检查生产 API、环境变量、HTTPS 与跨域设置。
更新代码后页面没变化
确认提交进入了平台监听的分支，查看最新部署是否成功，必要时检查 CDN 缓存而不是反复改代码。
课后练习
完成一次从空仓库到公网 URL 的部署，并保存四项证据：本地构建结果、远端提交、平台构建日志、无痕窗口中的核心流程截图。然后故意修改一处文案并再次推送，验证自动部署链路。