Nginx 的 alias 指令通过精准替换匹配路径实现开发与生产环境的静态资源路径隔离，需配合不同 server 或 location 块、注意末尾斜杠一致性及避免正则 location 中误用。
Nginx 的
指令本身不直接实现“环境隔离”，但它能配合不同 server 块或 location 配置，让开发和生产请求分别映射到不同本地路径，从而达成路径层面的隔离效果。关键在于：用
替换
，精准控制静态资源的物理路径映射，避免路径拼接错误，再结合条件（如域名、端口、HTTP 头）区分环境。
理解 alias 和 root 的核心区别
是“替换整个匹配路径”，
是“拼接路径”。这对环境隔离很关键：
→ 请求
对应文件是
→ 同样请求会去找
（多了一层
）
开发时常用
直接指向构建输出目录（如
），生产则指向另一个路径（如
），不依赖项目结构一致，更灵活。
用不同 server 或 location 区分环境入口
常见做法是通过域名或端口区分开发与生产流量，各自配置独立的
：
开发环境用
或
，
指向本地
或
生产环境用
，
指向
示例配置片段：
配合变量或 map 实现单配置动态切换（进阶）
如果想共用一份 Nginx 配置但按请求特征切换路径，可用
定义变量，再在
中引用（注意：
不支持变量，需改用
+ 重写，或用
+
组合）：
推荐方式：用
设置一个环境标识，再用
+
调整 URI，最后用固定
；或更稳妥地，用
+
分别查找不同前缀路径
例如：根据请求头
，将
内部重写为
，再用
映射到对应目录
注意事项：alias 的坑要避开
容易出错，影响隔离效果：
末尾斜杠必须一致：若
以
结尾，
值也建议以
结尾；否则可能路径错位
不能在正则 location 中直接使用
（Nginx 1.19+ 支持，但低版本会报错），建议改用
+
不支持多个路径 fallback，如需容错，需搭配
或 upstream
路径隔离的本质是“请求路径 → 物理路径”的确定性映射。
提供了比
更直接的控制能力，只要 location 设计清晰、路径约定明确，开发与生产就能互不干扰。
aliasaliasrootaliasrootlocation /static/ { alias /data/dev/static/; }/static/js/app.js/data/dev/static/js/app.jslocation /static/ { root /data/dev; }/data/dev/static/js/app.jsstaticaliasdist/var/www/prodaliaslocalhost:8080dev.example.comalias./dist/Users/name/project/distexample.comalias/var/www/example/current/dist
server {
listen 8080;
server_name localhost;
location /assets/ {
alias /path/to/your/project/dist/;
}
}
server {
listen 80;
server_name example.com;
location /assets/ {
alias /var/www/example/current/dist/;
}
}
mapaliasaliasroottry_filesaliasmapifrewritealiasroottry_filesX-Env: dev/assets//dev/assets/aliasaliaslocation/alias/aliasrootrewritealiastry_filesaliasroot