Alias指令实现服务器端URL到物理目录的前缀替换映射，不重定向、不拼接：location /static/ { alias /project/dist/; }请求/static/css/main.css时实际读取/project/dist/css/main.css。
Alias 指令本身不重定向（不改变浏览器地址栏），而是做**服务器端的路径映射**：把某个 URL 路径“悄悄”指向服务器上完全不同的物理目录，且不依赖网站 root 设置。关键在于“前缀替换”，不是追加，也不是跳转。
理解 alias 的核心行为：替换而非拼接
location 匹配的是请求 URI 的前缀，alias 值会**完全替代这个前缀**，再把剩余路径拼上去。
- 配置：location /static/ { alias /project/dist/; } → 请求 /static/css/main.css 实际读取 /project/dist/css/main.css
- 对比 root：location /static/ { root /project; } → 同样请求会去找 /project/static/css/main.css（多了一层 static）
- alias 是“去掉 /static/，剩下 /css/main.css，拼到 /project/dist/ 后面”；root 是“在 /project 后直接加完整路径 /static/css/main.css”
必须严格匹配末尾斜杠
location 和 alias 的结尾斜杠必须一致，否则路径会粘连出错，导致 404。
- location 以 / 结尾（表示目录匹配），alias 也必须以 / 结尾：location /api/docs/ { alias /opt/swagger-ui/; }
- location 不以 / 结尾（表示精确匹配单个文件），alias 就不能带 /，且应指向具体文件：location /favicon.ico { alias /var/www/favicon.ico; }
- 反例：location /static/ { alias /project/dist; } → 请求 /static/logo.png 会找 /project/distlogo.png（缺斜杠导致粘连）
常见实用场景与写法
alias 特别适合静态资源分离、多前端共存、磁盘迁移等场景。
- 前端项目独立部署：location /admin/ { alias /var/www/admin/; try_files $uri $uri/ /admin/index.html; }（配合 try_files 支持 Vue/React history 模式）
- 图片分片存储：location /img/ { alias /data/pics/2026/08/; } → /img/abc.jpg 查找 /data/pics/2026/08/abc.jpg
- 缓解磁盘压力：把大体积资源映射到另一块空闲磁盘，如 location /uploads/ { alias /mnt/data/uploads/; }
注意事项和避坑点
alias 看似简单，但权限、路径、语义三处最容易出问题。
- alias 不能和 root 出现在同一个 location 块里——语义冲突，Nginx 会报错
- 目标目录需有执行权限（Linux 下目录要有 x 权限），Nginx 工作进程用户（如 www-data）必须能进入并读取文件
- alias 不支持变量（如 $host、$1）和正则捕获拼接，也不能用 rewrite 替代其功能
- 调试时可用 error_log /var/log/nginx/debug.log notice; 配合 nginx -t 和 nginx -s reload 快速验证
