alias指令核心是前缀替换而非路径拼接，需location以/结尾精确匹配，如location /api/v1/docs/ { alias /opt/swagger-ui/; }；与root本质不同，前者替换前缀，后者追加完整uri。
alias 指令的核心作用，就是让 URL 路径和服务器上真实的文件路径“长得不一样”——比如访问 /api/docs/，实际读取的是 /opt/swagger-ui/ 目录下的文件。这不是拼接，而是前缀替换，所以才能实现非对称映射。
理解 alias 的替换逻辑
alias 不是把 URI “加到”某个目录后面，而是把 location 匹配到的整个前缀“拿掉”，再用 alias 后面的路径“顶上去”。关键在“替换”，不在“追加”。
- 配置：
location /static/ { alias /var/www/assets/; } - 请求：
/static/css/app.css - Nginx 实际查找：
/var/www/assets/css/app.css（/static/被完整移除）
斜杠必须严格对应
末尾斜杠不是风格问题，而是行为开关。location 和 alias 的结尾斜杠要保持一致，否则会路径粘连或截断错误。
- ✅ 正确：
location /images/ { alias /data/pics/; }→/images/logo.png→/data/pics/logo.png - ❌ 错误：
location /images/ { alias /data/pics; }→/images/logo.png→/data/picslogo.png（少个/，直接粘连） - ⚠️ 注意：location 写成
/images（无尾斜杠）可能只匹配精确路径，无法覆盖子路径，通常应带/
搭配正则实现动态映射
静态前缀不够用时，可以用正则捕获组构造目标路径，让映射更灵活。
- 需求：把
/v1/users/list映射到/opt/api-v2/users/list - 配置：
location ~ ^/v1/(.+)$ { alias /opt/api-v2/$1; } - 说明：$1 是捕获的
users/list，alias 值中不强制加尾斜杠，但要确保拼接后路径语义正确
别和 root 混用，选错就 404
root 是“原样拼接”，alias 是“前缀替换”。选哪个，取决于你希望 URL 是否出现在磁盘路径里。
- 用 root：URI 层级和目录结构一致，比如
/img/下真有img/文件夹 →root /var/www;找/var/www/img/xxx - 用 alias：URI 只是入口别名，不想暴露真实层级，比如
/admin/指向独立 Vue 构建产物 →alias /project/admin-dist/;找/project/admin-dist/xxx - SPA 非根部署、CDN 回源、API 文档托管等场景，基本都该用 alias
