核心原因是配置文件未注册进服务提供者：需在boot()中调用publishes()，register()中调用mergeConfigFrom()，并执行config:clear刷新缓存。
为什么 php artisan vendor:publish 不生效？
核心原因通常是配置文件没被正确注册进服务提供者。Laravel 不会自动扫描包里的 config/ 目录，必须显式调用 $this->publishes()。
常见错误现象：php artisan vendor:publish --provider="Vendor\Package\ServiceProvider" 执行后无任何输出，或提示 “No publishable resources for tag []”。
- 检查服务提供者的
boot()方法里是否调用了$this->publishes()，且路径参数是真实存在的 PHP 数组文件（如__DIR__.'/../config/package.php'） - 确保该配置文件返回的是纯数组，不能含
return new Config(...)或依赖容器解析的逻辑 - 如果用了标签（
--tag），发布时必须用完全一致的字符串，大小写敏感，比如package-config和Package-Config是两个不同标签
vendor:publish 的 --tag 和 --provider 怎么选？
两者定位不同：--provider 指向具体类，适合调试阶段精准触发；--tag 更适合生产环境批量管理，也方便用户按需选择发布内容（比如只发配置不发迁移）。
使用场景：你维护一个含配置、迁移、视图的包，用户可能只想导出配置，不想覆盖已有迁移——这时必须用 --tag 隔离资源。
- 在服务提供者中注册时，推荐同时指定
provider和tag：$this->publishes([$path => config_path('package.php')], 'package-config'); - 运行命令时，优先用
php artisan vendor:publish --tag=package-config，比反复试--provider更可靠 - 多个包用了相同 tag 名（如都叫
config），会导致冲突，务必加前缀，如myapp-config
配置文件导出后为啥还是读不到值？
因为 Laravel 的 config() 辅助函数默认只加载框架自带配置和已通过 ConfigServiceProvider 注册的项，不会自动 reload 你刚发布的文件。
本质问题：发布只是复制文件，不是注册配置源。你需要手动在服务提供者的 register() 或 boot() 中加载它。
- 最稳妥做法是在服务提供者
register()里加：$this->mergeConfigFrom(__DIR__.'/../config/package.php', 'package'); - 注意第二个参数是配置键名，之后要用
config('package.key')访问，不是文件名 - 如果跳过这步，即使文件已存在
config/package.php，config('package')仍返回null - 开发中改了配置要
php artisan config:clear，否则缓存会掩盖 merge 失败的问题
Laravel 10+ 的 shouldDiscoverPackages() 影响发布吗？
不影响发布机制本身，但会影响“是否需要手动指定 --provider”。开启自动发现后，Laravel 会尝试加载包的服务提供者，但前提是包的 composer.json 里声明了 "extra": {"laravel": {"dont-discover": false}}（默认为 false）。
容易踩的坑是：本地测试时开了自动发现，上线却因生产环境 composer 配置或缓存导致未加载服务提供者，结果 vendor:publish 找不到目标。
- 不要依赖自动发现来做发布前提，始终在文档里写明需手动执行
vendor:publish - 检查
composer dump-autoload -o是否成功，失败会导致自动发现失效，而错误不报在 publish 阶段 - 若包支持多版本 Laravel，
shouldDiscoverPackages()在 5.5–8.x 返回 bool，在 9+ 返回 array，别直接 return true/false
真正卡住人的地方从来不是命令敲错，而是 mergeConfigFrom 漏了、tag 写重了、或者 config:clear 忘了——这些点不报错，只静默失效。
