如何在不修改vendor目录的情况下调试Composer依赖包？（本地路径映射）

推荐使用 Composer 的 path repository 功能替代直接修改 vendor 代码，通过在 composer.json 中配置本地路径仓库并指定对应包版本，可实现本地实时调试且不破坏 vendor 结构。

直接在 vendor 里改代码不是长久之计，也容易被 composer update 覆盖。用 Composer 的 path repository 功能，把本地开发中的包映射进项目，既能实时调试，又完全不碰 vendor 原始结构。

配置本地 path repository

在项目的 composer.json 里添加自定义仓库，指向你本地的包目录：

{
    "repositories": [
        {
            "type": "path",
            "url": "../my-awesome-package"
        }
    ],
    "require": {
        "vendor/my-awesome-package": "dev-main"
    }
}

注意几点：

• url 是相对于当前 composer.json 的路径，支持绝对路径或相对路径
• 本地包目录下必须有合法的 composer.json，且 name 字段要和 require 中一致
• 版本号（如 dev-main）需匹配本地包的分支名或 version 字段，Composer 会自动识别

让 Composer 优先使用本地包

默认情况下，Composer 可能仍从 Packagist 拉取稳定版。确保本地包生效，可以：

标签： js json composer ai