Url::to() 是生成带参数链接的最稳妥方法，自动处理路由规则、URL美化、参数编码和base URL；传数组时键名须严格匹配路由定义的参数名，而非数据库字段名。
Yii2 中 Url::to() 生成带参数链接的正确写法
直接用 Url::to() 最稳妥，别手写拼接。它自动处理路由规则、URL美化（urlManager 配置）、参数编码和 base URL 前缀，手拼 ?id=1&name=test 容易漏转义或错配路由。
常见错误是传数组时键名写成路由别名以外的字段，比如在 'post/view' 路由下硬塞 ['post_id' => 123]，但实际路由规则定义的是 post，不是 post_id。
- 路径字符串 + 关联数组：传路由别名（如
'post/view'）和匹配该路由所需的参数键名（如['id' => 42]），不是数据库字段名 - 绝对路径或外部链接：直接传字符串，如
Url::to('https://example.com')，不走路由解析 - 相对路径：如
Url::to(['site/index'])或Url::to(['view', 'id' => 5])，后者会按当前控制器补全前缀 - 加锚点或查询参数：用第 2 个参数控制是否加
baseUrl，第 3 个参数可追加锚点，如Url::to(['user/profile'], true, 'section2')
为什么 Url::toRoute() 和 Url::to() 基本等价
两者底层都调用同一个解析逻辑，Url::toRoute() 是显式强调“这是路由”，Url::to() 更通用（支持字符串路径、数组路由、甚至空数组返回首页）。实际项目里混用没问题，但建议统一用 Url::to()，减少认知负担。
容易踩的坑是误以为 toRoute() 会强制走路由匹配而 to() 不会——其实都会。区别只在语义和第 1 个参数类型容忍度：to() 接受字符串路径（如 /admin/user/index），toRoute() 只接受数组或字符串路由别名（如 'admin/user/index'）。
- 传数组时行为完全一致，都走
urlManager->createUrl() - 传字符串且含
/开头：两者都当路径处理，不走路由别名查找 - 传不含
/的字符串（如'login'）：两者都尝试匹配路由别名 - 性能无差异，不用纠结选哪个
URL 参数中文/特殊字符乱码或 404 的原因
根本原因是没让 Yii 知道这个参数要进 URL 路径段（path segment），而是当成 query string 处理了。比如路由配置是 'post/，你却传 ['id' => '测试']，正则 \d+ 根本不匹配，结果 fallback 到 query 模式，但 URL 美化开启时 query 模式被禁用，最终 404。
解决办法只有两个：改路由规则支持非数字（如 'post/），或确保传入值严格符合规则。中文必须编码后传，但注意：不是手动 urlencode()，而是让 Url::to() 自己处理——它对 path segment 中的非 ASCII 字符默认用 rawurlencode()，只要路由正则允许（比如用 [^\/]+）。
- 检查
urlManager->enablePrettyUrl是否为true，否则所有参数都会变成 query 形式 - 确认路由规则中参数占位符的正则能覆盖你要传的值，例如
- 避免在参数里传未过滤的用户输入，尤其斜杠
/会截断路径，导致路由匹配失败 - 调试时打印
Url::to(['post/view', 'id' => '中文'])看输出，如果出现%E4%B8%AD%E6%96%87是正常的，浏览器会自动解码
生成带 HTTPS 和子域名的完整 URL
靠 Url::to() 自身做不到，它只管路径部分。必须配合 Url::to() + 手动拼协议和域名，或者用 Url::to(['...'], true) 让它加 baseUrl，再确保 urlManager->baseUrl 已设为完整地址（如 https://api.example.com）。
更可靠的做法是：在入口文件或配置里明确设置 Yii::$app->urlManager->hostInfo = 'https://shop.example.com'，之后所有 Url::to(..., true) 都会带上这个 hostInfo。不设的话，默认取当前请求的 $_SERVER['HTTP_HOST']，多域名部署时容易出错。
-
Url::to(['order/detail'], true)生成完整 URL，前提是hostInfo正确 - 不要在模板里反复写
https://' . $_SERVER['HTTP_HOST'] . Url::to(...)，既难维护又绕过 Yii 的 URL 管理机制 - API 场景下常需跨域 URL，这时
hostInfo必须显式配置，不能依赖请求头 - 开发环境用
http，生产环境用https，可通过环境变量动态设置hostInfo
路由参数名和正则约束的耦合是最容易被忽略的点——传参看着对，但路由规则卡住了，连 debug 日志都不报错，只默默 fallback 到 404 页面。
