Nginx 通过 set 指令支持运行时局部变量，仅限当前请求生效，需在使用前初始化；推荐用 map 替代 if+set 实现高效安全的条件映射，变量可用于 rewrite、proxy_pass 等场景。
Nginx 本身不支持传统编程语言中的变量赋值和逻辑运算，但通过 set 指令（需启用 ngx_http_rewrite_module，默认已编译）可以在 server 块中定义**运行时局部变量**，用于简化重复判断、统一路径处理、动态拼接值等场景。关键在于理解它的作用域、执行时机和限制。
变量只在当前请求生命周期内有效
set $my_var "value"; 定义的变量仅对当前 HTTP 请求生效，不会跨请求共享，也不影响其他 worker 或连接。它不是全局配置变量（如 env 或 map），也不是编译期常量。常见误用是试图在 log_format 外直接引用未赋值的变量，或期望它在 proxy_pass 后还能被下游读取——实际不能。
- 变量必须在使用前通过
set、map或内置变量（如$host）初始化，否则为空字符串 - 同一请求中多次
set同名变量，以最后一次为准 - 不能在
if块外直接依赖if内的set（因if是惰性执行，且有作用域陷阱）
用 set 避免重复写长路径或条件表达式
当多个指令需共用某个计算结果（如基于域名的根路径、带版本号的静态资源前缀），可用 set 提前定义，提升可读性和可维护性：
server {
server_name example.com www.example.com;
<pre class="brush:php;toolbar:false;"># 统一提取主域名作为基础路径标识
set $base_path "/var/www/html";
if ($host ~ ^www\.(.+)$) {
set $base_path "/var/www/html/www";
}
location /static/ {
alias $base_path/static/;
}
location / {
root $base_path;
try_files $uri $uri/ /index.html;
}}
注意：if + set 组合虽常用，但要避免在 if 中做复杂逻辑；更推荐用 map 实现无副作用的映射（见下条）。
配合 map 实现安全、高效的条件变量（推荐优先级高于 if+set）
map 指令在配置加载时预编译，性能更好，且规避了 if 的执行顺序问题。适合根据请求头、域名、参数等生成变量：
map $host $app_root {
default "/var/www/default";
example.com "/var/www/app-v1";
~^staging\..+$ "/var/www/app-staging";
~^v2\.example\.com "/var/www/app-v2";
}
<p>server {
listen 80;
server_name example.com staging.example.com v2.example.com;</p><pre class="brush:php;toolbar:false;">root $app_root;
location /api/ {
proxy_pass http://backend;
proxy_set_header X-App-Root $app_root; # 也可透传给后端
}}
这样既避免了 if 嵌套，又让变量逻辑集中、清晰、可测试。
set 变量在 rewrite 和 proxy_pass 中的典型应用
动态构造重定向地址或代理目标时，set 能减少硬编码：
- 将带参 URL 重写为干净路径：
set $clean_uri $1; rewrite ^/item/(\d+)$ /item?id=$clean_uri last; - 根据请求头切换上游：
if ($http_x_env = "prod") { set $upstream "https://prod-api"; } if ($http_x_env = "dev") { set $upstream "https://dev-api"; } proxy_pass $upstream;（注意：此处if仍存在风险，生产建议改用map） - 拼接带时间戳的缓存键：
set $cache_key "$host$request_uri|$msec";，再用于proxy_cache_key
不复杂但容易忽略：所有 set 变量在 proxy_pass 中若含协议（如 https://），必须确保 Nginx 编译时启用了对应模块（如 http_ssl_module）；纯域名或 IP 则无此限制。
