Composer调试时怎么安装本地包？快捷开发技巧-composer-PHP中文网

必须用 path 类型仓库，因 Composer 默认只从远程仓库拉包，本地代码需在 repositories 中声明且配置正确才能被识别和加载。

composer调试时怎么安装本地包？快捷开发技巧

必须用 path 类型仓库，其他方式基本都会导致类加载失败或改了代码不生效。

为什么 `composer require vendor/name` 不能直接装本地代码

Composer 默认只从 Packagist 或配置的远程仓库拉包，require 后面写的版本号（比如 "^1.2"）会触发远程解析，根本不会看你电脑上有没有同名目录。就算你把源码 clone 到 ./packages/my-package，只要没在 repositories 里声明，它就当不存在。

常见错误现象：

执行 composer require vendor/name 报 Could not find package vendor/name
手动把代码复制进 vendor/，但 class_exists('VendorClass') 返回 false
改了本地包里的 PHP 文件，主项目运行结果完全没变化

怎么配 `path` 仓库让 Composer 找到本地包

在主项目的 composer.json 顶部加 repositories 块，url 必须是相对于该文件的路径，且目标目录下必须有合法的 composer.json（含 name 和 version）。

示例配置：

{
  "repositories": [
    {
      "type": "path",
      "url": "../my-local-package"
    }
  ],
  "require": {
    "vendor/my-local-package": "dev-main"
  },
  "minimum-stability": "dev",
  "prefer-stable": true
}

关键点：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

url 不能用 ~/、/full/path 或 ../ 跨出项目根目录（Composer 2.5+ 会直接拒绝）
require 中的版本号必须匹配本地包 composer.json 里的 version 字段，比如写 "dev-main"，就不能指望 "dev-master" 生效
必须设 "minimum-stability": "dev"，否则 dev-main 这类开发版会被过滤掉
改完后别直接 composer install——先删掉 composer.lock，否则旧锁文件会跳过新仓库

`composer update vendor/name` 之后还是没链接成功？检查这三处

执行完 composer update vendor/my-local-package，vendor/vendor/my-local-package 应该变成符号链接（Linux/macOS）或目录映射（Windows）。如果没变，大概率是下面某个环节断了：

本地包 composer.json 的 name 字段和主项目 require 里的名字不一致（大小写、连字符、斜杠位置错一个都不行）
本地包目录下没有 autoload 配置，或者 PSR-4 映射末尾漏了反斜杠，比如写成 "MyPackage\": "src" 而不是 "MyPackage\": "src/"
主项目没运行 composer dump-autoload，autoload 文件没更新，类自然找不到

验证是否真生效：

Linux/macOS 下执行 readlink vendor/vendor/my-local-package，输出应为相对路径
运行 php -r "echo class_exists('MyPackage\Helper') ? 'ok' : 'fail';"，输出 ok 才算 autoload 通了

别碰 `composer link`，除非你清楚它只对已安装包有效

composer link 不是通用方案，它只对「已经通过 composer require 安装过的包」起作用，本质是在 vendor/ 下建软链接，但不改 composer.lock，也不同步 autoload 规则。一旦后续执行 composer update，链接大概率被覆盖回远程包。

如果你只是想快速调试，又没在 repositories 里提前配好 path 仓库，那它可能“看起来快”，但实际埋了坑：