Vercel Root Directory 对照表
Vercel 的 Root Directory 保存在项目设置中,不由 Git 仓库里的文件自动迁移。目录改造后,如果日志出现 The specified Root Directory ... does not exist,说明项目仍使用旧目录;更新设置后再重新部署即可。
当前迁移记录如下。路径相对于仓库根目录填写,不要加开头的 /。
| 项目用途 | 旧 Root Directory(已失效) | 新 Root Directory | 构建命令 | 输出目录 |
|---|---|---|---|---|
| 小蓝书 · MiniMaxi M2 | ui-ux-redbook-waterfall-images-minimaxi-m2 |
demos/bluebook/runs/minimax-m2-unknown-r01 |
npm run build |
dist |
| 小蓝书 · MiniMax M2.1 | ui-ux-redbook-waterfall-images-minimax-m2.1 |
demos/bluebook/runs/minimax-m2-1-unknown-r01 |
npm run build |
dist |
| 小蓝书 · Claude 4.0 | ui-ux-redbook-waterfall-images |
demos/bluebook/runs/claude-4-0-unknown-r01 |
npm run build |
dist |
| 自选股前端 | stock-watching-system/frontend |
demos/stock-watching/runs/unknown-unknown-r01/frontend |
按项目设置 | 按项目设置 |
本次报错的修复步骤
报错项目对应 MiniMaxi M2。打开 Vercel 项目的 Settings → Build and Deployment,将 Root Directory 改为:
demos/bluebook/runs/minimax-m2-unknown-r01
保存后重新部署。该目录内已经包含 package.json、package-lock.json、vite.config.ts 和可运行的 build script,Vercel 可以直接执行 npm run build 并发布 dist。如果项目设置过自定义 Install Command,保留 npm ci;没有自定义命令时使用 Vercel 默认值即可。
后续目录迁移
- 先在
catalog/migration-v2.json记录旧路径和新路径。 - 确认新 Root Directory 内包含该项目自己的依赖清单和构建配置。
- 在每个对应的 Vercel 项目设置中更新 Root Directory,并触发一次部署。
- 将最终路径补充到本表;GitHub Pages 仍然只通过提交到 GitHub 自动发布,不增加额外发布步骤。
不要把 Root Directory 指向 previews/:那里是 GitHub Pages 使用的已构建静态预览,不是 Vercel 的源码构建目录。