必须用相对路径，且是相对于主项目composer.json文件的位置；绝对路径在windows或unix下均易导致静默失败或解析错误，正确示例为"../my-local-package"。
path仓库必须用绝对路径还是相对路径？
必须用相对路径，且是相对于主项目 composer.json 文件的位置。Composer 的 path 类型仓库不支持 Windows 绝对路径（如 C:my-package）或 Unix 绝对路径（如 /home/user/my-package），强行写入会导致 composer install 报错：Could not parse version constraint *: Invalid version string "*" 或静默失败。
正确写法示例（主项目在 D:projectsmy-app，本地包在同级 D:projectsmy-local-package）：
{
"repositories": [
{
"type": "path",
"url": "../my-local-package"
}
],
"require": {
"vendor/my-local-package": "*"
}
}
- 路径中不能含空格或中文，否则 Windows 下链接可能创建失败（即使 composer 不报错，运行时类加载会提示
Class not found） - 推荐用
..向上跳转，避免跨盘符（如从D:指向E:）——Composer 不支持 - 执行
composer update vendor/my-local-package即可只刷新该包，不用重装全部依赖
为什么 composer install 后没生成符号链接？
常见原因不是配置写错，而是本地包的 composer.json 缺少必要字段或格式非法。Composer 对 path 仓库的包有隐式要求：它必须能被当作合法包解析，否则直接跳过链接。
确保本地包根目录下 composer.json 至少包含：
{
"name": "vendor/my-local-package",
"type": "library",
"autoload": {
"psr-4": {
"Vendor\MyLocalPackage\": "src/"
}
},
"require": {
"php": "^8.0"
}
}
-
name必须与主项目require中的包名完全一致（包括大小写和斜杠方向） -
autoload是硬性要求：没有自动加载配置，Composer 会拒绝将其识别为可安装包 - 如果本地包目录里有
composer.lock，删掉它——path包不走版本锁定逻辑，留着反而干扰解析 - 执行
composer install -v查看详细输出，若看到Skipped package ... because it has no name defined就说明name字段缺失或为空
修改本地包代码后，主项目为何不生效？
因为 Composer 的 path 仓库默认创建的是**硬链接（hard link）**（Windows）或**符号链接（symlink）**（Linux/macOS），而非复制文件。这意味着你改本地包的 src/，主项目立刻可见——但前提是自动加载器已重新注册。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型失效场景和解法：
- 改了类名或命名空间 → 必须运行
composer dump-autoload，否则 PSR-4 映射未更新 - 改了
composer.json中的autoload规则 → 同样要dump-autoload，且需确认新规则与实际目录结构匹配 - 用了
opcache.enable=1（PHP 默认开启）→ 重启 Web 服务器或 CLI 进程，否则旧字节码仍被缓存 - IDE（如 PHPStorm）未识别链接路径 → 在项目设置中将本地包目录标记为 “Sources”，否则跳转和补全失效
如何让本地包同时支持 path 开发和 packagist 发布？
关键在于分离开发态和发布态的仓库声明。不要把 path 配置长期留在主项目的 composer.json 里，否则协作时别人拉代码会因路径不存在而失败。
推荐做法：用 Composer 的 config 机制临时注入路径仓库：
在主项目根目录执行：
composer config --local repositories.my-local-package '{"type":"path","url":"../my-local-package"}'
再运行：
composer require vendor/my-local-package:dev-main
-
--local表示仅当前项目生效，生成的配置写入composer.json同级的composer.local.json（Composer 2.2+ 支持）或直接写进composer.json的config字段，但不会污染提交历史 - 用
dev-main而非*，明确指向分支，避免后续发布正式版时意外升级 - 上线前删掉这行配置，切回 packagist 源：运行
composer config --local --unset repositories.my-local-package - 这个流程可固化为脚本，比如
./dev-setup.sh，团队新人一键接入
composer validate 检查两个 composer.json 的语法，比反复重装快得多。
