alias指令完全替换location匹配前缀，root则拼接完整uri；alias值末尾必须加/（目录映射时），且需与location结尾斜杠一致，否则路径粘连致404。
alias 指令用于将请求的 URI 路径映射到文件系统中的另一个目录，它和 root 的核心区别在于：alias 会**完全替换 location 中匹配的部分**，而 root 是拼接路径。
alias 路径匹配的基本写法
location 块中使用 alias 时，必须注意末尾斜杠（/）是否一致，否则容易导致 404。关键规则是：
- location 以 /xxx/ 结尾 → alias 值也应以 / 结尾（表示目录）
- location 匹配的是完整前缀，不带正则时按最长前缀匹配；带 ~ 或 ^~ 时按对应规则匹配
- alias 后面的路径不包含 location 中已匹配的部分
例如，想把 /static/css/ 请求映射到 /var/www/assets/css/：
location /static/css/ {
alias /var/www/assets/css/;
}
此时访问 /static/css/main.css，Nginx 实际查找的是 /var/www/assets/css/main.css —— 注意 /static/css/ 被完全替换为 alias 值，不是拼接。
常见易错场景与写法对比
错误写法（末尾斜杠不一致）：
location /static/css/ {
alias /var/www/assets/css; # ❌ 缺少结尾 /，会导致找 /var/www/assets/cssmain.css（连在一起）
正确写法（保持结尾斜杠对齐）：
location /static/css/ {
alias /var/www/assets/css/; # ✅
如果 location 不带结尾斜杠（如精确匹配单个文件）：
location = /favicon.ico {
alias /var/www/static/favicon.ico; # ✅ alias 指向具体文件，不加 /
alias 配合正则 location 的写法
当用 ~ 正则匹配时，alias 不能直接引用捕获变量（$1 等），但可通过 rewrite + break 或改用 root 更稳妥。更推荐的做法是避免在正则 location 中混用 alias，除非明确需要：
location ~ ^/img/(.+)\.(png|jpg|gif)$ {
alias /var/www/images/$1.$2; # ✅ 可行，但需确保 $1.$2 构成合法文件名
}
注意：正则中的 alias 必须指向完整绝对路径+文件名，且 Nginx 不会自动补全扩展名或目录分隔符。
alias 和 root 的选择建议
多数静态资源场景下，root 更安全、更直观：
- 用 root：location /static/ { root /var/www; } → 请求 /static/js/app.js → 查找 /var/www/static/js/app.js
- 用 alias：location /static/ { alias /var/www/static/; } → 请求 /static/js/app.js → 查找 /var/www/static/js/app.js
alias 真正适用的典型场景是：URI 路径和磁盘路径结构不一致，比如把 /api-docs/ 映射到 /opt/swagger-ui/dist/ 这类“路径别名”需求。
