alias实现url到文件系统的精确映射：location必须以/结尾，alias值为真实路径（不编码、不转义），拼接逻辑为“去掉匹配前缀后拼接”。
alias 路径别名不是“额外起个名字”，而是用 location 匹配前缀 + alias 指定真实路径 实现 URL 到文件系统的精确映射。写法核心就三点：location 必须以 / 结尾、alias 值必须是服务器上真实存在的路径（不编码、不转义）、拼接逻辑是“去掉匹配前缀，再拼到 alias 后面”。
location 和 alias 的基础写法
这是最常用也最安全的模板：
- location 必须带结尾斜杠，比如
location /static/ { ... }，不能写成location /static - alias 后面的路径要以
/结尾（除非指向单个文件），例如alias /var/www/assets/; - 客户端请求
/static/css/main.css→ Nginx 去掉/static/，剩下css/main.css，再拼到/var/www/assets/后，得到真实路径/var/www/assets/css/main.css
含空格或中文的路径怎么写
alias 后面直接写原始路径，不 URL 编码，也不加反斜杠转义：
- ✅ 正确：
alias /var/www/my site/中文目录/;（空格和中文照原样写） - ❌ 错误：
alias /var/www/my%20site/%E4%B8%AD%E6%96%87/;（URL 编码路径，Nginx 找不到） - ❌ 错误：
alias "/var/www/my\ site/";（Shell 风格转义，在 Nginx 配置里无效） - 注意：确保该路径在服务器上真实存在，且 Nginx 工作进程用户（如 www-data）有读取权限，目录还要有执行（x）权限才能进入
映射单个文件的写法
如果只想把某个 URL 映射到一个固定文件（比如 favicon 或健康检查页），alias 可以不加结尾斜杠：
location = /favicon.ico { alias /var/www/icons/favicon.ico; }location = /health { alias /var/www/status.html; }- 注意：
=表示精确匹配，避免意外匹配其他路径；alias 指向的是完整文件路径，不是目录
常见错误与避坑提示
很多 403、404 其实不是路径写错，而是逻辑理解偏差：
- location 没写结尾斜杠 → 导致截断不完整，拼出错误路径（比如
location /api匹配/api/v1/data，可能只去掉/api，剩下v1/data，拼出来变成/path/v1/data） - alias 指向目录但没加
/→ Nginx 会把它当文件处理，返回 404 或 500 - 混用 alias 和 try_files → 容易行为不可控，尤其是 SPA 回退路由，建议优先用 root + try_files
