^~ 是 Nginx 中的前缀匹配修饰符，URI 以指定路径开头即立即匹配并跳过所有正则规则；区分大小写、性能高、优先级仅次于精确匹配 =，常用于静态资源或 API 前缀代理。

在 Nginx 中，^~ 是一个前缀匹配修饰符，作用是：一旦 URI 以指定路径开头，就立即采用该 location 块处理请求，并且跳过后续所有正则匹配（~ 和 ~*）。它不参与正则运算，只做字符串前缀比对，性能高、行为确定。

^~ 的核心特点

• 区分大小写，仅检查 URI 起始部分是否完全一致
• 匹配成功后不再检查任何 ~ 或 ~* 规则，哪怕后面有更“贴切”的正则表达式
• 优先级仅次于 = 精确匹配，高于所有正则和普通前缀匹配
• 多个 ^~ 规则共存时，按最长前缀匹配，长度相同时以配置顺序为准（但通常建议避免同长冲突）

典型使用场景

• 静态资源目录（如 /static/、/assets/、/images/）
• API 前端代理路径（如 ^~ /api/v1/）
• 需要屏蔽正则干扰的高频固定路径

正确配置示例

以下配置确保所有以 /static/ 开头的请求都走本地文件服务，且不会被后面的图片正则规则捕获：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

location ^~ /static/ {
  alias /var/www/static/;
}
location ~* \.(jpg|png|gif)$ {
  expires 1y;
  add_header Cache-Control "public";
}
location / {
  proxy_pass http://backend;
}

→ 请求 /static/logo.png：命中 ^~ /static/，返回文件，不进正则块
→ 请求 /uploads/photo.jpg：跳过 ^~，进入 ~* 规则处理
→ 请求 /static/js/app.js：同样走 ^~ 块，即使 .js 后缀没在正则里也没关系

常见错误提醒

• 不要混用 ^~ /path 和 /path（无修饰符）在同一配置中，Nginx 会报 duplicate location
• ^~ 后面的 URI 必须以 / 开头，且不能包含正则元字符（如 . $ *）
• 它不支持通配符或模糊路径，比如 ^~ /static/*/css/ 是非法的，必须写成确定前缀