!~ 是区分大小写的正则取反匹配，但不能作为 location 前缀；必须用于 if 判断或结合 location 优先级实现排除逻辑。
Nginx 的 location 块中，!~ 用于**区分大小写的正则取反匹配**，即“不匹配该正则表达式时才生效”。它不能单独作为 location 类型前缀（如 !~ /abc 是无效语法），必须配合其他 location 类型使用——最常见的是在 if 指令中判断，或与常规 location ~ 配合实现“排除”逻辑。
!~ 只能在 if 中使用，不能直接写在 location 后
Nginx 官方语法规定：location 后只支持以下前缀：
-
=（精确匹配） -
^~（前缀匹配，且优先于正则） -
~（区分大小写正则匹配） -
~*（不区分大小写正则匹配） - 无前缀（普通前缀匹配）
!~ 和 !~* 不是合法的 location 前缀，直接写 location !~ \.php$ { ... } 会导致 Nginx 启动失败（报错：invalid number of arguments in "location" directive）。
正确实现“排除正则”的两种常用方式
方式一：用 if + $request_uri 或 $uri 判断（推荐用于简单排除）
例如：对所有请求启用 gzip，但排除 .js 和 .css 文件
location / {
if ($request_uri !~ \.(js|css)$) {
gzip on;
}
# 其他配置...
}
⚠️ 注意：if 在 location 中有局限性（比如不能嵌套、部分变量不可用），且过度使用可能影响性能和可读性。
方式二：用两个 location 分流（更清晰、更高效）
例如：将除 /api/v1/health 外的所有 /api/ 请求代理到后端，而健康检查接口直接返回 200
# 先匹配排除项（精确或正则）
location = /api/v1/health {
return 200 'OK';
}
<h1>再匹配主规则（注意：~ 匹配，但不包含上面已匹配的路径）</h1><p>location ~ ^/api/ {
proxy_pass <a href="https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e">https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e</a>;
}</p>
✅ 这里利用了 Nginx location 匹配优先级：= 最高，会先于 ~ 匹配成功，自然实现“排除”效果。
方式三：用正则否定字符组（适用于简单模式）
例如：匹配以 /static/ 开头、但不以 .php 结尾的路径
location ~ ^/static/.*(?<p>⚠️ 注意：Nginx 使用 PCRE 正则，支持负向先行断言 <code>(?，但需确保 PCRE 版本较新（≥8.32），且该写法可读性较差，不建议复杂场景使用。</code></p><h3>实际建议：优先用 location 优先级代替 “取反”</h3><p>多数“排除需求”本质是“优先处理特例”，因此推荐：</p>
- 把要排除的路径写成高优先级 location（如
=、^~或~精确正则） - 再用低优先级 location 处理剩余通用路径
- 避免在
if中做路径判断，尤其不在if中使用proxy_pass等指令（易出错）
比如禁止访问所有 .git 目录，但允许 /public/.gitignore：
location ~ /\.git {
deny all;
}
location = /public/.gitignore {
allow all;
log_not_found off;
}
注意顺序无关紧要，因为 = 优先级高于 ~，Nginx 自动先匹配精确项。
