要初始化可被 Composer 加载的 Laravel 扩展包，需确保其为符合 PSR-4 规范的 Composer 包：执行 composer init 设置 vendor/name 格式 name，声明 autoload 中的 psr-4 映射，运行 composer dump-autoload；若本地开发，需在主项目 composer.json 的 repositories 中添加 path 类型仓库并 require @dev；启用自动发现须同时满足 type: "laravel-package" 和 extra.laravel.providers 配置；Service Provider 必须在 register() 中绑定服务、继承正确 Facade 基类；发布资源需在 boot() 中调用 publishes()/loadMigrationsFrom()/loadViewsFrom() 并指定 tag。

如何初始化一个可被 Composer 加载的 Laravel 扩展包

扩展包必须是一个符合 PSR-4 自动加载规范的 Composer 包，否则 composer require 后 Laravel 根本不会识别你的服务提供者或 Facade。关键不是“写个包”，而是让 Composer 能定位类、让 Laravel 能发现服务。

执行以下操作：

• 在独立目录（如 myvendor/laravel-awesome）中运行 composer init，设置 name 为 myvendor/laravel-awesome（格式必须是 vendor/name）
• 在 composer.json 中明确声明 autoload 规则，例如：

  "autoload": {
    "psr-4": {
      "MyVendor\Awesome\": "src/"
    }
  }

• 运行 composer dump-autoload（开发时本地测试必须做，否则新类不生效）
• 若包尚未发布到 Packagist，需在主项目 composer.json 的 repositories 中添加本地路径：

  "repositories": [
    {
      "type": "path",
      "url": "../laravel-awesome"
    }
  ]

  再 composer require myvendor/laravel-awesome @dev

为什么 Service Provider 不被自动注册

Laravel 5.5+ 支持包自动发现（Package Discovery），但前提是你的包满足两个硬性条件：一是 composer.json 中必须有 extra.laravel.providers 数组；二是该包必须被声明为 type: laravel-package。

常见错误是只写了 providers 却漏了 type，导致 php artisan package:discover 完全跳过你的包：

• 在 composer.json 中补全：

  "type": "laravel-package",
  "extra": {
    "laravel": {
      "providers": [
        "MyVendor\Awesome\AwesomeServiceProvider"
      ]
    }
  }

• 如果用的是 Laravel config/app.php 的 providers 数组里加一行：MyVendorAwesomeAwesomeServiceProvider::class
• 运行 php artisan config:clear 后再试，缓存不清理，改了也不生效

Facade 类找不到或静态方法报错 Call to undefined method

Facade 本质是代理，它不自己实现逻辑，只通过 getFacadeAccessor() 拿到容器中绑定的实例。出错几乎都是因为绑定名和访问器返回值不一致。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

检查这三点：

• Facade 类中 protected static $facadeAccessor = 'awesome' —— 这个字符串必须和 Service Provider 中 $this->app->singleton('awesome', ...) 或 $this->app->bind('awesome', ...) 的第一个参数完全一致
• 确保 Service Provider 的 register() 方法里确实执行了绑定（很多人只写了 boot() 却忘了 register()）
• Facade 类必须继承 IlluminateSupportFacadesFacade，且不能漏掉 use 声明；别手误写成 extends Facade 而没指定完整命名空间

本地开发时配置文件/迁移/视图无法发布

php artisan vendor:publish 能否列出你的包，取决于 Service Provider 是否实现了 provides() 并正确声明了资源类型。默认情况下，Laravel 只看到你绑定了什么，看不到你想发布什么。

在 Service Provider 的 boot() 中显式加载资源：

• 配置文件：用 $this->publishes([__DIR__.'/../config/awesome.php' => config_path('awesome.php')], 'awesome-config')
• 迁移：用 $this->loadMigrationsFrom(__DIR__.'/../database/migrations')（仅 Laravel 5.5+），否则需手动复制
• 视图：用 $this->loadViewsFrom(__DIR__.'/../resources/views', 'awesome')，并在视图中用 @include('awesome::partial')
• 发布命令要加 tag：php artisan vendor:publish --tag=awesome-config，不加 tag 就不会出现在列表里

注意 __DIR__ 的位置：必须指向 ServiceProvider 所在文件，否则路径计算会错——这是最常被忽略的路径陷阱。