alias 实现 URL 到物理目录的精准替换，核心是删除 location 匹配前缀后拼接剩余路径；location 和 alias 均须以 / 结尾，配合 try_files 可实现 SPA 回退与容错。
用 alias 指令做 URL 到物理目录的“精准替换”，关键不是“指向”，而是“去掉前缀再拼剩余路径”。它不追加、不嵌套，只替换——这是和 root 最本质的区别。
明确 location 与 alias 的匹配关系
location 定义的是 URL 前缀，alias 定义的是要替换成的目标路径。Nginx 会把请求 URI 中匹配到的 location 部分**整个删掉**，再把剩下的路径拼到 alias 后面。
- 配置：
location /api/ { alias /opt/backend/static/; } - 请求：
/api/v1/logo.png - 实际查找文件：
/opt/backend/static/v1/logo.png（/api/被完整剔除）
必须守好的两条硬规则
漏掉任一细节都会导致 404 或路径错乱：
-
location 必须以
/结尾（如/static/），否则 Nginx 可能只截掉部分字符串，造成路径偏移 -
alias 值末尾也必须带
/（如/var/www/assets/），否则 Nginx 会把它当文件名处理，而非目录
多子应用共存时的干净映射
一个 Nginx 实例托管多个前端项目，靠 alias 避免路径嵌套冲突：
location /admin/ { alias /var/www/admin/; try_files $uri $uri/ /admin/index.html; }location /docs/ { alias /opt/swagger-ui/; try_files $uri $uri/ /index.html; }- 每个 location 独立生效，互不干扰；Vue 打包的
publicPath设为/admin/也能正确加载资源
配合 try_files 实现容错与 SPA 回退
alias 本身只做路径映射，不处理缺失资源。加上 try_files 才能兜底：
- 静态资源缺失时返回 404？加
try_files $uri =404;显式控制 - Vue/React 的 history 模式刷新报 404？写成
try_files $uri $uri/ /index.html;（注意：alias 下 fallback 的/index.html是相对于 alias 目录的，所以需确保该文件存在） - 不建议在 alias 块中混用变量（如
$host）或 rewrite，Nginx 不支持运行时拼接 alias 路径
