codeigniter 4 多语言路由需显式配置语言前缀，否则 /zh/home 等路径因无匹配规则直接报404；必须将带前缀路由置于通配符路由之前，通过 $routes->get('/zh/home', 'home::index') 等方式声明，并配合命名路由或手动拼接生成正确链接，同时清除路由缓存确保生效。
在 CodeIgniter 4 中为多语言站点配置路由时，常因语言前缀与路由规则冲突、命名空间混淆或缓存残留导致 /zh/home 或 /en/about 访问直接报 404，甚至中文路由段被截断或重定向循环。
语言前缀路由必须显式声明
CodeIgniter 4 不会自动识别 /zh/、/en/ 这类路径为语言标识——它只当作普通 URI 段处理。若未在 Routes.php 中明确定义带前缀的路由，框架根本不会尝试提取语言代码，而是直接匹配整个 /zh/home 字符串，自然找不到对应规则。
方法一：为每种语言单独注册静态路由
在 app/Config/Routes.php 的默认路由组中添加：
$routes->get('/zh/home', 'Home::index');<br>$routes->get('/en/home', 'Home::index');<br>$routes->get('/zh/about', 'Page::about');<br>$routes->get('/en/about', 'Page::about');
⚠️ 注意：【所有语言前缀路由必须放在通配符路由（如 $routes->get('(:any)', ...);）之前】，否则 /zh/home 会被通配符先捕获，语言参数无法传递给后续逻辑。
方法二：用正则占位符统一捕获语言代码
添加一条高优先级路由，将语言代码作为第一个参数提取：
$routes->get('/(:any)/(:any)', 'LanguageRouter::route/$1/$2');
然后创建 app/Controllers/LanguageRouter.php，手动解析 $1（语言码）、$2（后续路径），再转发到对应控制器。这一步需要你自行实现路由分发逻辑，不推荐新手直接使用。
语言参数不能靠自动路由隐式传递
CI4 默认禁用自动路由（$routes->setAutoRoute(false)），即使你把控制器方法写成 public function index(string $lang = 'zh')，框架也不会从 URL 中自动注入 $lang 参数——URL 路径和方法参数之间没有绑定关系。
第一步：在路由定义中显式传参
例如，让 /zh/contact 映射到 Contact::show 并传入 'zh'：
$routes->get('/zh/contact', 'Contact::show/zh');
第二步：修改控制器方法签名以接收该参数
确保 app/Controllers/Contact.php 中的 show() 方法接受字符串参数：
public function show(string $lang = 'zh') {<br> locale_set($lang); // 假设你有 locale_set() 辅助函数<br> return view('contact', ['lang' => $lang]);<br>}
第三步：注意参数顺序与占位符类型匹配
若用 (:num) 却传入 'zh'，匹配失败；必须用 (:any) 或自定义正则如 ([a-z]{2}) 才能正确捕获语言码。
语言切换链接生成易出错
使用 site_url() 生成多语言链接时，若未在路由中注册带前缀的别名，生成的地址仍是 /home，而非 /zh/home。
方法1：手动拼接（最稳妥）
在视图中直接写：@#@#@#@#@#@#@#@#@#@0
方法2：注册命名路由并传参
在 Routes.php 中添加：
$routes->get('/(:any)/home', 'Home::index')->setName('home_lang');
然后在视图中调用：@#@#@#@#@#@#@#@#@#@1
这一步操作起来很简单，直接把语言码作为参数传进去就行。但要注意：命名路由的参数顺序必须与 URI 中占位符出现顺序严格一致，否则生成的链接会丢失语言段。
语言检测中间件与路由缓存冲突
如果你在 BaseController 构造函数或中间件中读取 URL 第一段作为语言码，并调用 Config\Services::language()->setLocale()，这个动作必须在路由匹配完成之后执行——而 CI4 的路由缓存会在首次请求时固化所有路由规则，若中间件提前修改了请求对象，可能导致后续请求路由失效。
清除路由缓存再验证：
php spark cache:clear && php spark routes
运行后检查输出列表中是否包含你定义的 /zh/home 等路由。如果没出现，说明缓存未刷新或路由语法有误。
