# AI 编程项目怎么部署：从代码到网址的通用指南

> 不依赖具体某个 AI 工具：任何 AI 生成的网站项目（静态或容器），部署上线的通用判断流程、方案选择和失败排查。
> 最近更新：2026-09-05
> 官方地址：https://mashangjia.com/guides/ai-coding-project-deploy/

## 直接答案

不管代码是 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，变成容器项目

## 通用部署步骤（托管平台路线）

1. 清理：删掉 `node_modules/`、`.git/`、`venv/` 等可再生目录。
2. 打包：静态项目打构建产物，容器项目打整个目录。zip 不超过 50MB。
3. 上传：[码上架](https://mashangjia.com/) 支持匿名快速发布，立即得临时网址。
4. 验收：手机打开、发给朋友打开，确认样式和功能正常。
5. 认领：注册账号把临时站转正式，之后可更新内容、绑域名、开付费。

## Agent 自动部署

如果不想再经历上面任何一步，对你的 AI 编程助手说：

> 读取 https://mashangjia.com/ai 的契约，按它部署我当前的项目。

契约是给 AI 读的机器可读文档，包含打包要求、上传接口、错误恢复。支持匿名发布（零凭据）和账号模式（你注册后把凭据交给你的 AI）。

## 失败排查速查

| 问题 | 大概率原因 |
|---|---|
| 打开空白 | SPA 路由没配回退；或构建产物目录传错 |
| 样式丢失 | 资源路径是绝对路径且部署在子路径 |
| 接口报错 | 项目有后端但传了静态通道 |
| 上传超限 | zip 里混进了 node_modules/.git |
| 临时网址失效 | 匿名临时站有生命周期，注册认领转正式 |

## FAQ

**Q：部署后怎么更新内容？**
重新打包上传即可，正式站点会更新为最新版本，网址不变。

**Q：可以同时部署到多个平台吗？**
可以。同一份静态产物传多个平台互不冲突，很多人用海外平台+国内平台双入口。

## 下一步

- 各工具专属指南：[Cursor](/guides/cursor-deploy-website/) · [Claude Code](/guides/claude-code-deploy-website/) · [Trae](/guides/trae-deploy-website/) · [Codex](/guides/codex-deploy-website/)
- 加收费能力：[AI 做的网站怎么加登录和付费](/guides/ai-website-login-payment/)