最可靠的是用=和^~明确终止匹配：=精确匹配、^~前缀匹配后跳过正则；正则须从具体到宽泛排列；兜底用location /；避免斜杠歧义；务必测试验证。

避免 location 优先级混淆，关键不是“记住顺序”，而是让配置逻辑不依赖隐式优先级——用明确的修饰符切断歧义路径。

= 和 ^~ 是最可靠的“终止符”

只要 URI 能被 = 精确命中，就绝不会落到其他规则；只要被 ^~ 前缀匹配上，正则块（哪怕写在它前面）一律跳过。这两类是真正能“一锤定音”的写法。

• 静态资源入口统一用 location ^~ /static/ { ... }，避免 location /static/ 和 location ~* \.(css|js)$ 之间因长度或顺序引发的意外覆盖
• 关键端点如登录页、健康检查接口，直接写 location = /login { ... } 或 location = /healthz { ... }，杜绝前缀匹配干扰

正则块必须按“从具体到宽泛”排列

所有 ~ 和 ~* 按配置顺序逐条尝试，第一个匹配即生效。所以不能把 ~* \.png$ 放在 ~* \.(jpg|jpeg|png|gif)$ 前面，否则后者永远不触发。

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• 把更窄的正则写在前面：先 ~* ^/api/v2/.*\.json$，再 ~* ^/api/.*\.json$
• 避免重叠逻辑：不要同时存在 ~* \.html$ 和 ~* \.(htm|html)$，保留后者即可
• 兜底正则（如 ~* \..*$）务必放在最后，否则会吃掉本该走前缀匹配的路径

普通前缀匹配（无修饰符）只用于兜底或泛路由

location /api 这类写法本身不危险，但容易和 location /api/users、location = /api 形成嵌套歧义。除非明确需要最长前缀行为，否则优先用 ^~ 或 = 替代。

• 把 location / 放在所有规则末尾，作为最终 fallback
• 若需分组路由（如所有 /admin/ 下请求走同一处理），写成 location ^~ /admin/ { ... }，而非 location /admin/
• 禁止混用 location /foo 和 location /foo/——斜杠结尾差异会导致匹配结果不同，统一约定是否带尾部斜杠

验证比记忆更有效

别靠脑内模拟，用 nginx -t + 实际请求测试最稳妥。对关键路径，可临时加 return 200 "matched: xxx"; 快速确认命中位置。

• 用 curl -I http://localhost/path 查看响应头或状态码，判断是否进对了块
• 开启 error_log /path/to/log notice;，配合 log_format 记录 $request_uri 和 $host，排查真实匹配路径
• 复杂场景可用 try_files 显式控制文件查找链，减少对 location 层级的依赖