项目迁移应优先使用 alias 指令实现“不改 URL，只换目录”，适用于 URL 结构不变但物理路径变更的场景；需严格匹配 location 与 alias 末尾斜杠，多模块可独立配置 location + alias，配合 try_files 实现 SPA 子路径路由兜底。
项目迁移时用 alias 指令平滑更改静态资源物理路径，核心是“不改 URL，只换目录”——让新旧物理路径对齐业务逻辑，避免前端重发请求、构建配置或 CDN 缓存失效。
先理清迁移场景再选 alias 还是 root
迁移常有两类路径变化：
- URL 路径结构不变，但文件实际存放在新目录（比如从
/var/www/old/dist搬到/opt/app/new-build）→ 用 alias - 整个站点迁移到新根目录，且 URL 层级与磁盘结构天然一致（如
/static/对应磁盘/data/static/）→ 可用 root，但 alias 更可控
只要 URL 前缀（如 /assets/、/admin/）不该出现在新路径里，就该用 alias。它不拼接、不追加，只替换，迁移最稳。
alias 配置必须严格配对斜杠
这是迁移中 404 的头号原因。location 和 alias 的末尾 / 必须语义一致：
-
✅ 正确写法：location
/assets/→ alias/opt/app/new-build/assets/ -
❌ 错误写法：location
/assets/→ alias/opt/app/new-build/assets（少尾斜杠，会拼成/assetsjs/app.js） -
❌ 错误写法：location
/assets（无尾斜杠）→ alias/opt/app/new-build/assets/（多尾斜杠，可能触发双斜杠或 404）
迁移时建议统一用带尾斜杠的写法，直观、容错强，也方便后续扩展子路径。
多模块并行迁移，用多个独立 location + alias
大型项目常含管理后台、文档中心、上传资源等不同构建产物，它们可能分布在不同挂载点或分区。alias 支持跨目录甚至跨磁盘映射：
location /admin/ { alias /mnt/ssd/admin-v2/dist/; try_files $uri $uri/ /admin/index.html; }location /docs/ { alias /srv/nfs/docs-prod/; autoindex off; }location /uploads/ { alias /data/shared/uploads/; }
每个模块可分批上线、单独验证，不影响其他路径。Nginx 不要求这些目录有共同父级，也不依赖项目结构一致性。
配合 try_files 实现前端路由兜底，避免 history 模式 404
Vue/React 等 SPA 部署在子路径（如 /myapp/）时，迁移后要确保深层路由（/myapp/list/detail）仍能加载 index.html：
- alias 必须指向构建产物根目录（如
/var/www/myapp/dist/），且结尾带/ - try_files 的 fallback 路径要带前缀：
try_files $uri $uri/ /myapp/index.html（不是/index.html） - 这样 Nginx 在
/myapp/上下文中解析$uri，回退时才正确命中 alias 目录下的index.html
迁移前后保持这一逻辑，前端无需改 base 或重打包。
