Composer包需通过服务提供者注册：实现thinkService接口并在register()中bind/singleton绑定，composer.json声明extra.think.providers，执行php think service:discover生成缓存，开发期可手动添加到config/app.php providers数组。
Composer包如何注册服务提供者到ThinkPHP容器
ThinkPHP 6+ 使用 thinkContainer 管理依赖，自定义包必须通过服务提供者（Service Provider）显式绑定，否则 Container::get() 找不到类。不注册就直接 new 或 use，等于白写。
实操建议：
- 服务提供者类必须实现
thinkService接口，重写register()方法 - 在
register()中调用$this->app->bind()或$this->app->singleton()绑定具体实现 - 包的
composer.json里需声明"extra": {"think": {"providers": ["Vendor\Package\ServiceProvider"]}}—— ThinkPHP 仅扫描这个字段加载服务提供者 - 别漏掉
composer dump-autoload，否则新写的ServiceProvider类根本不会被自动加载
为什么 vendor/autoload.php 加载后服务提供者仍不生效
常见错误现象：php think service:discover 没反应，或运行时抛出 ClassNotFoundException，但 composer show 能看到包已安装。
根本原因不是自动加载失败，而是 ThinkPHP 的服务发现机制没触发。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 确认是否执行过
php think service:discover—— 这条命令会扫描vendor/*/composer.json中的extra.think.providers，生成runtime/service.php缓存 - 开发阶段别依赖自动发现：手动在
config/app.php的'providers'数组里追加你的服务提供者类名（如Vendor\Package\ServiceProvider::class） - 检查服务提供者类命名空间是否与
composer.json的"autoload": {"psr-4": {...}}完全匹配，大小写敏感，尤其 Windows 下容易因路径缓存导致加载失败
自定义包里的类无法被 IDE 识别或类型提示失效
现象是 PHPStorm / VS Code 显示 “Undefined class” 或跳转失败，但运行正常。这不是 ThinkPHP 问题，而是 Composer 自动加载配置和 IDE 索引脱节。
实操建议：
- 确保包的
composer.json中"autoload"使用psr-4，且路径指向实际源码目录（如"src/": "src/"），别写成"src/": "src"少了斜杠 - 运行
composer dump-autoload -o生成优化后的自动加载映射，再重启 IDE 索引（VS Code 可按Ctrl+Shift+P→ “Index workspace”） - 如果包内有 Facade 类，需在
config/app.php的'facades'中手动注册别名，否则 IDE 不知道MyPackage::doSomething()对应哪个类
服务提供者中 bind() 和 singleton() 的选择影响什么
绑定方式决定对象生命周期，直接影响状态共享、内存占用和测试隔离性。用错会导致“上一次请求的数据污染下一次请求”这类典型问题。
实操建议：
- 无状态工具类（如加密、日志格式化）用
$this->app->singleton()—— 单例省资源，也安全 - 带请求上下文依赖的类（如需要当前
Request实例）必须用$this->app->bind()，否则构造函数注入的Request是首次创建时的快照，后续请求拿不到新数据 - 避免在
register()里执行耗时操作（如读配置文件、连数据库），ThinkPHP 在每次请求都执行所有register()，性能敏感场景建议延迟到boot()或首次 get 时初始化
服务提供者的 boot() 方法常被忽略，但它才是真正适合放“依赖已就绪后才执行”的逻辑的地方——比如监听事件、注册中间件、修改全局配置。别把什么都塞进 register()。
