path仓库需在repositories中设"type": "path"并指定含composer.json的绝对路径或以../开头的相对路径，且require的包名须与本地composer.json的name一致，推荐加"symlink": true实现实时生效。
composer.json 里怎么写 path 类型仓库
路径仓库本质是让 Composer 把本地文件夹当远程包用，不用发包、不用 push，适合调试或私有组件开发。关键在 repositories 字段里声明类型为 path，并指向含 composer.json 的目录。
常见错误：路径写成相对路径但没注意当前工作目录；或者路径里漏了 composer.json，导致 composer install 报错 Could not find package xxx at version *。
- 路径必须是绝对路径，或以
../开头的相对路径（从项目根目录算起） - 目标目录下必须有有效的
composer.json，且其中name字段要和你require的包名完全一致 - 推荐加
"options": { "symlink": true }，这样修改本地包代码能实时生效，避免反复composer update
示例（项目根目录下的 composer.json）：
{
"repositories": [
{
"type": "path",
"url": "../my-local-package",
"options": {
"symlink": true
}
}
],
"require": {
"acme/my-local-package": "*"
}
}
为什么 require 后 composer install 没拉到本地代码
最常见原因是版本约束不匹配——path 仓库不会自动匹配所有版本，它只提供本地 composer.json 中定义的 version 字段（如果写了），或默认当成 dev-main（Git 分支名）或 dev-master。如果你 require 的是 "^1.0"，但本地包没设 "version": "1.0.0"，Composer 就找不到满足条件的版本。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 最省事做法：把本地包的
composer.json中version设为"dev-main"（或"dev-develop"），然后require对应的分支别名，比如"acme/my-local-package": "dev-main" - 不写
version也行，但必须用dev-前缀 + 分支名，且确保该分支存在（Composer 会查 Git HEAD） -
composer update acme/my-local-package比install更可靠，尤其改过本地仓库配置后
path 仓库和 symlink 的实际行为差异
加了 "symlink": true 不等于“软链整个 vendor”，而是 Composer 在安装时，对这个包执行 ln -s（Linux/macOS）或 mklink（Windows），把 vendor/acme/my-local-package 指向你指定的本地路径。好处是改代码立刻生效；坏处是运行时路径是真实的本地路径，可能暴露开发机敏感信息（比如绝对路径出现在错误堆栈里）。
- 没开 symlink：Composer 会把本地包内容复制进
vendor/，后续修改需手动composer update - 开了 symlink：删除本地包目录会导致
vendor/下链接失效，composer dump-autoload可能报错 - CI/CD 环境通常禁用 symlink（因为没本地路径），所以
path仓库仅限开发阶段使用
Windows 下路径仓库的坑
Windows 用户最容易卡在路径分隔符和权限上。Composer 内部用的是 Unix 风格路径处理逻辑，所以即使你在 Windows 上，url 字段也不能写 C:\projects\my-pkg，得写 C:/projects/my-pkg 或 ../my-pkg。
- 避免盘符大写问题：
c:/和C:/在某些 PHP 版本下会被视为不同路径 - 防病毒软件可能拦截 symlink 创建，导致
composer install静默失败或报failed to create symbolic link - WSL 用户注意：不要混用 Windows 和 WSL 路径，比如从 WSL 运行 Composer 却指向
/mnt/c/...，性能差且 symlink 可能不可靠
本地包开发这事，核心就两条：路径必须可访问，版本必须对得上。其他都是围绕这两点打转。别在 CI 里用 path，也别指望它替代真正的包管理流程。
