运行 php artisan tinker 即可启动 laravel Tinker，它基于 PsySH 提供友好交互环境；Laravel 8+ 默认内置，旧版需手动安装 psy/psysh，常见问题包括路径错误、依赖缺失、中文乱码等。
怎么启动 Laravel Tinker
运行 php artisan tinker 即可进入交互式 PHP 环境，它默认使用 PsySH，比原生 PHP CLI 更友好。注意：Laravel 8+ 默认已内置，旧版本需确认是否安装了 psy/psysh（通过 composer require --dev psy/psysh 补上）。
常见卡住或报错场景：
- 终端无响应 → 检查是否在项目根目录下执行，且
.env配置正确（尤其数据库连接，Tinker 启动时会加载服务提供者） -
class 'PsyShell' not found→ 缺少psy/psysh，运行composer require --dev psy/psysh - windows 下中文乱码 → 在 CMD 中先执行
chcp 65001，或改用 git bash / windows Terminal
Tinker 中如何加载模型和执行查询
Tinker 不是普通 PHP CLI，它自动引入了 Laravel 的应用上下文，所以可以直接用 Eloquent 模型、Facade 和依赖注入功能。
典型操作示例：
-
User::first()→ 查第一条用户记录（会触发实际数据库查询） -
app('cache')->get('key')→ 调用缓存门面 -
resolve(AppServicesUserService::class)->syncAll()→ 解析并调用自定义服务 -
DB::table('users')->where('id', 1)->first()→ 使用 Query Builder
⚠️ 注意：Tinker 默认开启「实时执行」，每行代码都会立即运行。写循环或修改数据前务必加 dd() 或 dump() 预览，避免误删生产数据。
为什么 tinker 里查不到刚插入的数据
最常见原因是事务未提交或数据库连接配置不一致。Tinker 使用的是当前环境的数据库连接，但某些情况会复用连接池或受事务隔离级别影响。
排查要点：
- 确认
.env中DB_DATABASE指向的是你预期的库（比如不是testing或sqlite::memory:） - 手动插入后没
DB::commit()？Tinker 不自动 commit，DB::transaction()块外需显式提交 - 用
DB::connection()->getPdo()->inTransaction()检查是否还在事务中 - mysql 默认
REPEAtable READ隔离级别下，同一连接中事务开始后看不到其他连接的更改 —— 此时换一个 Tinker 进程重试更直观
如何在 Tinker 中调试复杂逻辑或复用代码
Tinker 支持多行输入（用回车换行，结束用两个空行），也支持从文件加载脚本：
- 写一段逻辑直接粘贴进去，支持
if、foreach、闭包等完整语法 - 保存为
debug.php，然后在 Tinker 中执行require 'debug.php'（路径相对于项目根目录） - 用
Ctrl+R搜索历史命令，Ctrl+A/Ctrl+E移动光标（依赖 PsySH 快捷键） - 想临时禁用日志/事件监听器？可在 Tinker 中执行
Event::fake()或Log::extend('NULL', function () { return new IlluminateLogNullLogger; })
真正容易被忽略的是：Tinker 的变量作用域是会话级的，关闭窗口后所有变量丢失；而 config 修改（如 Config::set('app.debug', true)）只在当前会话生效，不影响后续请求 —— 别指望靠它“永久打开 debug”。