ThinkPHP 6+ 可选参数唯一合法写法是[:id]，中括号紧贴冒号变量；[id]被当字面量，:id?为Laravel语法不识别；控制器方法参数必须设默认值如$id = null；多段可选需各自加中括号如[:year]/[:month]/[:day]；路由缓存未清或顺序错误会导致静默失效。
可选参数必须用[:id]，不是[id]或:id?
ThinkPHP 6+ 中，可选参数的唯一合法写法是[:id]——中括号紧贴冒号变量，且冒号不能省。写成[id]会被当作文本字面量，:id?是 Laravel 风格，在 TP 里不识别，直接导致参数无法注入控制器方法。
常见错误现象：访问/user能进控制器，但$id始终为null或空字符串；或者/user/123匹配失败，报 404。
-
Route::get('user/[:id]', 'user/info');→ 正确，/user和/user/123都匹配 -
Route::get('user/[id]', 'user/info');→ 错误，id不会被解析为变量 -
Route::get('user/:id?', 'user/info');→ 错误，TP 不支持问号语法
控制器方法参数必须设默认值，否则 PHP 报错
即使路由声明了[:id]，PHP 函数签名仍要求显式提供默认值，否则调用时触发Missing argument致命错误。这不是 ThinkPHP 的 bug，而是 PHP 强类型函数调用机制决定的。
使用场景：你希望/user显示列表，/user/123显示详情，共用一个方法。
立即学习“PHP免费学习笔记（深入）”；
当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。
- ✅ 正确写法：
public function info($id = null) { ... } - ✅ 或更严谨：
public function info($id = 0) { if (!$id) { /* 列表逻辑 */ } else { /* 详情逻辑 */ } } - ❌ 错误写法：
public function info($id) { ... }→ 访问/user时直接报错
多个可选段要各自加中括号，不能合并或嵌套
[]只作用于它紧邻的单个 URL 段，跨斜杠无效，也不能嵌套。想让/blog/2026/9/1、/blog/2026/9、/blog/2026、/blog都匹配，必须每个段单独包裹。
容易踩的坑：写成'blog/[year/month/day]'或'blog/[:year/:month]/[:day]'，前者语法错误，后者会导致/blog/2026/9/1根本匹配不上。
- ✅ 正确：
Route::get('blog/[year]/[month]/[day]', 'blog/archive'); - ✅ 更推荐（带变量）：
Route::get('blog/[:year]/[:month]/[:day]', 'blog/archive')->pattern(['year'=>'\d{4}', 'month'=>'\d{1,2}', 'day'=>'\d{1,2}']); - ❌ 错误：
'blog/[year/month]'、'blog/[:year/[:month]]'、'blog/[:year]/[:month]/day'（最后段没括号就变必填）
缓存不清理、顺序放错，可选参数就“假装不存在”
开发中改了[:id]却没生效？大概率是路由缓存没清，或者被前面更宽泛的规则提前匹配掉了。
性能影响：生产环境开启route_check_cache能提速，但开发阶段它就是隐形障碍。
- 执行
php think route:clear强制刷新缓存，别信 IDE 自动保存 - 把带中括号的路由写在通用规则之前，例如把
user/[:id]放在[:any]或*之前 - 运行
php think route:list确认你的路由显示为Optional或带?标记，而不是Required - 如果用了域名绑定或分组，检查前缀是否多占了一个段——比如分组前缀是
admin，那admin/user/[:id]里的[:id]才是第二段，别数错
可选参数看着简单，但[:id]的写法、控制器参数默认值、多段独立括号、缓存与顺序这四点只要漏掉一个，就会静默失效——它不会报错，只是参数拿不到，排查起来特别费时间。
