多语言网站路径重写需将 /en/about 等带语言标识路径映射为统一后端结构，支持无前缀默认语言（如 /about → ?lang=zh），通过 nginx rewrite 规则标准化路径、提取语言码、补全参数，并确保 seo 友好与路径一致性。
多语言网站路径重写，核心是把带语言标识的请求（比如 /en/about、/zh/contact）映射到统一后端结构，同时支持无前缀默认语言（如中文），还要兼顾 SEO 友好和用户感知一致。Nginx 本身不处理语言逻辑，靠 rewrite 规则提前“标准化”路径即可。
识别并提取语言参数
最常用方式是用 URL 路径开头作为语言标识，例如 /en/xxx、/ja/yyy。需用正则捕获语言码，并重写为带查询参数或内部路径的形式：
-
rewrite ^/([a-z]{2})(?:/|$)(.*)$ /$2?lang=$1 last;—— 把/en/blog→/blog?lang=en，方便后端读取$arg_lang - 若后端约定目录结构（如
public/en/），可用：rewrite ^/([a-z]{2})/(.*)$ /$2?lang=$1 last;，再配合try_files $uri /index.php?$args;转发 - 注意：语言码限制为 2 字母（
[a-z]{2}）可避免误匹配，如/error不被当成语言
默认语言免前缀，但保持语义一致
用户访问 /about 应视为默认语言（比如中文），不能直接 301 跳转破坏 SEO，而应在内部重写时补上 lang 参数：
- 先匹配带语言前缀的路径，排除干扰；再对无前缀路径加默认值：
if ($request_uri ~ ^/[^/]+$) { set $lang_default zh; } - 更稳妥做法是用 location 分离：
location ~ ^/([a-z]{2})/ { rewrite ^/([a-z]{2})(/.*)?$ $2?lang=$1 last; }，然后location / { rewrite ^/(.*)$ /$1?lang=zh last; } - 关键点：所有入口最终都带
?lang=xxx，后端统一处理，避免分支逻辑散落
支持语言切换时保留原路径
用户在 /en/products/widget 点击“中文”按钮，应跳转到 /zh/products/widget，而非首页。这靠 Nginx 的变量组合实现：
- 利用
$request_uri和$arg_lang构造新路径：if ($arg_lang = "zh") { rewrite ^/(en|ja)/(.*)$ /zh/$2? permanent; } - 更通用写法（适配任意源语言）：
if ($arg_lang != "") { rewrite ^/([a-z]{2})/(.*)$ /$arg_lang/$2? permanent; }，但需确保$arg_lang是可信值（如白名单校验） - 实际部署中建议前端控制跳转，Nginx 仅做兜底；若必须由 Nginx 处理，可在 server 块里用 map 提前定义合法语言集，避免注入风险
避免循环和优先级冲突
rewrite 规则执行顺序敏感，尤其和 location 嵌套时容易出错：
-
last表示重写后重新匹配 location；break则停止重写，直接处理当前 location —— 多语言场景几乎都用last，确保重写后的路径能进到正确的静态或 PHP 处理块 - 不要在同一个 location 内混用多个 rewrite，易产生歧义；推荐按功能拆分：
location / { ... }处理无前缀，location ~ ^/[a-z]{2}/ { ... }单独处理带前缀路径 - 检查是否被其他规则覆盖：比如 root 或 alias 设置在 location 外层，会导致重写后路径拼接错误；务必把 rewrite 放在 location 内部，且紧贴顶部
