手动安装Laravel Bagisto配送时间段包时遇到PSR-4自动加载错误

我最近尝试把自定义的Bagisto配送时间段包手动安装到Laravel项目里，做法是把包放在项目的./packages/目录下，目前已经完成了这些操作：

• 将包放置到packages/Webkul/DeliveryTimeSlot目录中
• 更新了主项目的composer.json文件，添加PSR-4自动加载配置（原配置内容有截断，推测完整配置应该包含Webkul\\DeliveryTimeSlot\\的映射）

但现在遇到了PSR-4自动加载错误，无法正常加载包内的类。

嘿，我之前手动安装Bagisto本地包的时候也踩过类似的坑，给你分享几个排查和解决的步骤：

1. 确认PSR-4映射配置的准确性 #

首先检查主项目composer.json里的自动加载配置是否完整正确。如果你的包源码都放在packages/Webkul/DeliveryTimeSlot/src目录下，那配置应该是这样的：

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Webkul\\DeliveryTimeSlot\\": "packages/Webkul/DeliveryTimeSlot/src/"
    }
}

注意命名空间的大小写要和目录名完全一致，末尾的斜杠也不能少，Bagisto的官方包都是以Webkul开头的命名空间，别写错了。

2. 重新生成Composer自动加载文件 #

修改完composer.json后，一定要在项目根目录运行这条命令，让Composer更新自动加载规则：

composer dump-autoload

这条命令会重新生成vendor/autoload.php文件，确保新增的本地包能被正确识别。

3. 检查包内的目录结构与命名空间匹配度 #

打开你包里的类文件，比如packages/Webkul/DeliveryTimeSlot/src/Models/TimeSlot.php，文件顶部的命名空间必须和目录结构严格对应：

namespace Webkul\DeliveryTimeSlot\Models;

如果类文件直接放在src目录下，命名空间就是namespace Webkul\DeliveryTimeSlot;，PSR-4是完全按照“命名空间对应目录路径”来加载的，哪怕大小写或者目录层级错了都会报错。

4. 配置本地包自身的composer.json（如果有的话） #

如果你自定义的包也有自己的composer.json文件，要确保里面的配置正确：

{
    "name": "webkul/delivery-time-slot",
    "autoload": {
        "psr-4": {
            "Webkul\\DeliveryTimeSlot\\": "src/"
        }
    }
}

正确的包配置能让主项目的Composer更好地识别和加载它。

5. 添加本地仓库到主项目的composer.json #

如果上面的步骤都没解决问题，可以尝试在主项目的composer.json里添加本地仓库配置，告诉Composer去哪里找这个包：

"repositories": [
    {
        "type": "path",
        "url": "packages/Webkul/DeliveryTimeSlot"
    }
]

然后运行这条命令来安装本地包：

composer require webkul/delivery-time-slot:dev-main

这里的版本号要和你包里composer.json里的版本对应，或者用你的开发分支名（比如dev-main），这样Composer会把本地包作为正式依赖加载，自动处理好自动加载的问题。

备注：内容来源于stack exchange，提问作者Tarun Kumar