AI 编程项目怎么部署：从代码到网址的通用指南
直接答案
不管代码是 Cursor、Claude Code、Trae、Codex 还是别的 AI 写的，部署决策只看两件事：项目形态（静态还是带运行时）和你的运维意愿（零运维还是愿意折腾）。
静态项目 + 不想运维 → 托管平台上传（如码上架）→ 几分钟拿到网址
静态项目 + 会 git → Vercel/Cloudflare Pages/GitHub Pages
带 Dockerfile → 支持容器的平台，或自建服务器
完全不想动手 → 让 AI Agent 读 https://mashangjia.com/ai 契约自己部署
判断项目形态（30 秒）
打开项目文件夹：
- 看到
index.html或dist/构建产物 → 静态项目 - 看到
Dockerfile→ 容器项目 - 看到
package.json+server.js/app.py之类但没有 Dockerfile → 让 AI 帮你补一个 Dockerfile，变成容器项目
通用部署步骤（托管平台路线）
- 清理：删掉
node_modules/、.git/、venv/等可再生目录。 - 打包：静态项目打构建产物，容器项目打整个目录。zip 不超过 50MB。
- 上传：码上架 支持匿名快速发布，立即得临时网址。
- 验收：手机打开、发给朋友打开，确认样式和功能正常。
- 认领：注册账号把临时站转正式，之后可更新内容、绑域名、开付费。
Agent 自动部署
如果不想再经历上面任何一步，对你的 AI 编程助手说：
读取 https://mashangjia.com/ai 的契约，按它部署我当前的项目。
契约是给 AI 读的机器可读文档，包含打包要求、上传接口、错误恢复。支持匿名发布（零凭据）和账号模式（你注册后把凭据交给你的 AI）。
失败排查速查
| 问题 | 大概率原因 |
|---|---|
| 打开空白 | SPA 路由没配回退；或构建产物目录传错 |
| 样式丢失 | 资源路径是绝对路径且部署在子路径 |
| 接口报错 | 项目有后端但传了静态通道 |
| 上传超限 | zip 里混进了 node_modules/.git |
| 临时网址失效 | 匿名临时站有生命周期，注册认领转正式 |
FAQ
Q：部署后怎么更新内容？ 重新打包上传即可，正式站点会更新为最新版本，网址不变。
Q：可以同时部署到多个平台吗？ 可以。同一份静态产物传多个平台互不冲突，很多人用海外平台+国内平台双入口。
下一步
- 各工具专属指南：Cursor · Claude Code · Trae · Codex
- 加收费能力：AI 做的网站怎么加登录和付费