nginx不支持变量跨文件自动继承，仅map、upstream、limit_req_zone等http块顶层定义的指令可在子配置中引用；set变量作用域限于当前server/location块；推荐用map定义动态变量、统一声明共享模块并include复用配置片段。
Nginx 本身不支持“变量继承”或“全局变量作用域跨文件自动传递”的机制。所谓“在子配置文件中继承全局变量属性”，实际是指：如何让在 nginx.conf 主配置中定义的变量（如 set、map、upstream、limit_req_zone 等）在 include 进来的子配置文件（如 sites-enabled/example.com）中可用。
变量（set/map）不能跨 context 或文件直接复用
Nginx 的 set 和 map 指令有严格的作用域限制：
-
set只能在server或location块内使用，且定义后仅在当前块及嵌套块生效；不能在http块顶层set后被子配置中的location直接引用（会报错“invalid number of arguments”或“unknown directive”）。 -
map必须定义在http块顶层，它定义的是变量映射关系，之后可在任意server/location中通过$var_name引用 —— 这是真正可“跨文件复用”的方式。
推荐做法：把可复用逻辑放在 http 块顶层
确保所有子配置能访问的通用配置，统一写在 nginx.conf 的 http 块内（主配置），再用 include 加载子文件：
- 用
map定义动态变量（如根据 host 设置环境标识）：map $host $env_name {<br> default "prod";<br> ~^staging\. example\.com$ "staging";<br>}
子配置中可直接写access_log /var/log/nginx/app-$env_name.log; - 用
upstream、limit_req_zone、log_format等指令统一声明在http块，子配置通过名称引用（如proxy_pass backend;、limit_req zone=api burst=10;）。 - 避免在子配置里重复定义同名
map或upstream，否则会报错“duplicate upstream”或覆盖行为不可控。
技巧：用 include 模拟“配置片段复用”
对于需要多处使用的配置块（如通用 header、重写规则），可单独提取为片段文件，在需要的地方 include：
- 创建
/etc/nginx/snippets/common-headers.conf：add_header X-Frame-Options "DENY";<br>add_header X-Content-Type-Options "nosniff";
- 在子配置的
server或location块中：include snippets/common-headers.conf; - 注意：这种 include 是文本包含，不是变量作用域合并；它只是把配置内容原样插入到当前位置。
不推荐的方式：试图“导出变量”或用 if + set 模拟全局
以下做法容易出问题，应避免：
- 在
http块写set $my_var "value";→ Nginx 会拒绝启动（语法错误）。 - 在
server块设变量，期望location继承 → 实际上location可以读取，但若子配置未显式include在该server内，则无效。 - 用
if在http块做条件赋值 →if不允许出现在http块顶层，会报错。
