Composer本地开发怎么调试？使用路径映射链接本地包【教程】-composer-PHP中文网

composer本地调试核心是用path仓库映射本地代码，需在主项目composer.json的repositories中配置type为path的绝对或相对路径，且本地包name、version须与require严格匹配，满足条件时composer install自动创建符号链接实现即时生效。

composer本地开发怎么调试？使用路径映射链接本地包【教程】

Composer 本地开发调试，核心不是“装包”，而是让 composer install 或 composer update 真正加载你正在写的本地代码，而不是从 Packagist 下载已发布的版本。路径映射（path repository）是唯一可靠、无需发布、可即时生效的方式。

为什么 `composer require vendor/name:dev-main` 不起作用？

很多人试过直接 require 开发分支，结果 Composer 仍拉远程 zip 或 git clone，改了本地代码完全没反应——因为 dev-main 这类版本别名默认指向 Packagist 上注册的源，不是你电脑里的文件夹。除非你同时在 repositories 里声明了本地 path 类型仓库，并把版本约束对齐，否则 Composer 根本不会看你的硬盘。

必须在项目根目录的 composer.json 中显式添加 repositories 配置
path 仓库的 url 值必须是绝对路径或相对于 composer.json 的相对路径（推荐用相对路径，避免换机器失效）
被依赖包自身的 composer.json 中 version 字段要与你在主项目中 require 的版本号严格匹配（例如写 "dev-main as 1.0.x-dev"，那本地包里就得有 "version": "1.0.x-dev" 或留空靠 Composer 自动推断）

怎么正确配置 `path` 仓库并启用符号链接？

Composer 默认对 path 类型仓库启用 symlink（软链接），但前提是：目标目录存在、有合法 composer.json、且未设 "symlink": false。只要满足条件，composer install 后会在 vendor/vendor/name/ 下生成指向你本地路径的链接，改代码立刻生效。

Discussion Composer

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

下载

在主项目 composer.json 的 repositories 数组开头加一项：
```
{
  "type": "path",
  "url": "../my-local-package"
}
```
确保 ../my-local-package/composer.json 存在，且 name 字段为 "vendor/name"（与 require 中一致）
运行 composer require vendor/name:@dev --no-update（先不更新），再 composer update vendor/name，强制触发 symlink 逻辑
检查 vendor/vendor/name 是否为链接：Linux/macOS 用 ls -l，Windows 用 dir 看是否显示 <symlinkd></symlinkd>

常见失败现象和对应检查点

执行完 composer update，发现还是复制了一份代码而非链接，或者报错 Could not find a matching version——基本是以下某处没对齐：

repositories.url 路径拼错（比如少了个 ..，或 Windows 下用了反斜杠 \）
本地包 composer.json 中 name 和主项目 require 的名字大小写不一致（Composer 区分大小写）
本地包没有 version 字段，而主项目 require 写了具体版本如 "1.2.3"（此时 Composer 无法匹配，应改用 "@dev" 或删掉 version 让其走 dev-main 分支逻辑）
本地包目录下有 .git，但当前分支不是 main 或 master，且没在 require 中指定分支别名（如 "dev-feature/foo as 1.0.x-dev"）