在 Laravel 项目开发过程中，打印 SQL 语句可是个超实用的技能，能帮咱解决不少难题。比如说调试代码的时候，程序报错或者数据出问题，直接查看执行的 SQL 语句，就能快速定位问题根源，看看是条件写错了，还是关联查询有毛病。还有优化性能时，知道了 SQL 咋写的，就能分析有没有全表扫描、索引没用上这些拖慢速度的情况，进而改写优化。而且对于复杂的查询逻辑，把 SQL 打印出来，能让咱更直观地明白数据是咋被检索、关联的，方便后续调整。总之，掌握打印 SQL 语句这一招，能让咱们的 Laravel 开发之路顺畅不少。

一、原生打印：快速上手但有局限

Laravel 原生就给咱们提供了方法来打印 SQL 语句，简单易操作。首先，咱得开启查询日志，用 DB::connection()->enableQueryLog(); 这行代码就行，就好比打开了一个记录 SQL 语句的小本本。接着，执行咱们的查询语句，比如说 App\User::find(1);，这是查找 users 表中 id 为 1 的用户记录。最后，用 dump(DB::getQueryLog()); 把记录的查询日志打印出来瞅瞅。来看个例子，执行完上述操作后，得到的结果可能是这样的：从这个结果能清楚看到查询语句的模板 select * from users where users.id =? limit 1，还有对应的参数绑定 [1]，以及执行耗时 11.87 毫秒。不过呢，这种方式把语句和参数分开显示，要是想直接拿去数据库客户端执行验证，还得手动把参数填到语句里，稍微有点麻烦，对于懒人开发者来说，能少一步是一步嘛，所以咱接着往下看更便捷的方法。

二、进阶玩法：获取完整 SQL 语句

（一）AppServiceProvider 中处理

要是觉得原生那种分开显示的方式不得劲，咱还有进阶的办法，能把完整的 SQL 语句打印出来，用着超顺手。这里面，先是对绑定参数来一波处理，日期格式的参数 \DateTime 实例化为特定格式字符串，字符串参数两边加上单引号。接着把处理好的参数，通过替换占位符 ? 为 %s，再用 vsprintf 函数按照参数顺序精准嵌入到查询语句模板里，就得到了完整的 SQL 语句。最后把这完整语句写到 storage/logs 目录下，以当天日期命名的 _query.log 文件里，方便咱随时查看。以后要是排查问题，直接打开对应的日志文件，里面的 SQL 语句拿去数据库客户端执行验证，那叫一个丝滑，啥问题都能快速定位。

（二）巧用监听事件

还有另一种巧妙的法子，利用监听事件来打印 SQL 语句。在需要打印 SQL 语句的前面，加上这么一段代码：比如说咱有这么个查询 DB::table('users')->where('age', '>', 20)->get();，在它前面放上监听代码。这里监听函数会捕捉到查询相关信息，回调函数里先拿到绑定参数和原始 SQL 模板，然后遍历绑定参数，数字就直接用，字符串就加上单引号，通过正则把 ? 占位符按顺序替换掉，最后用 Log::info 把完整 SQL 语句记录到日志里。查看日志的时候，就能清晰看到完整执行的 SQL，像 select * from users where age > '20'，不管是调试还是优化，都能轻松拿捏。

三、实用技巧与注意事项

虽说打印 SQL 语句好处多多，但也有些小窍门和要注意的地儿。在本地开发环境，大胆打印，方便调试，各种方法尽管招呼，出了问题能立马定位。可要是到了生产环境，就得悠着点了，别一股脑开启大量 SQL 打印，不然日志文件 “蹭蹭” 涨，占用存储空间不说，频繁写入还会拖慢系统性能，影响用户体验。要是项目里，有些查询语句涉及敏感信息，像用户密码（虽然一般都加密存储，但也保不准特殊情况）、商业机密数据啥的，打印的时候就得万分小心，别泄露出去，该做模糊处理就别手软，安全这根弦可得绷紧咯。另外，根据项目的复杂程度和需求，灵活选用打印方式。简单排查问题，原生打印快速看看也行；长期优化、复杂调试，那就用进阶方法把完整 SQL 精准记录，让咱的开发工作稳稳当当向前推进。

总结

咱这回一起深入探究了 Laravel 打印 SQL 语句的门道，从原生的简单开启查询日志、查看分开的语句和参数，到进阶的在 AppServiceProvider 里精心处理绑定参数、把完整 SQL 精准记录到日志，还有巧用监听事件实时捕捉并转化出可用的 SQL 语句，各有各的妙处。这技能可是咱开发 Laravel 项目的得力助手，不管是调试代码、优化性能，还是捋清复杂查询逻辑，都能派上大用场。希望大伙别光看，多在自己的项目里实践实践，依据项目特点灵活选用方法，让开发效率 “蹭蹭” 往上涨，代码质量也更上一层楼，在 Laravel 开发的世界里畅行无阻。