推荐使用Composer path仓库配合符号链接实现热更新：在主项目composer.json的repositories中配置相对路径的"type":"path"源，本地包需含合法name且require用"dev-main"，执行composer update后改代码立即生效。
本地开发时怎么让主项目实时加载修改中的包代码
默认 composer require 远程包后，改完本地代码必须 composer update 才生效，效率极低。真实开发必须走 path 仓库模式，靠符号链接（symlink）实现热更新。
关键操作有三处：
- 在主项目根目录的
composer.json的repositories数组里加一条：[{"type": "path", "url": "../my-pkg", "options": {"symlink": true}}]（Windows 用户必须显式写"symlink": true，否则静默 fallback 到 copy 模式） - 本地包目录下要有合法的
composer.json，其中name必须为vendor/name格式（如"acme/utils"），且大小写完全匹配主项目require中写的名称 - 执行
composer require acme/utils:dev-main（注意带:dev-main），之后改../my-pkg/src/里的代码，主项目立刻可见——前提是ls -la vendor/acme/utils显示-> ../my-pkg
为什么 composer require vendor/name 总报 “Could not find package”
这不是网络问题，也不是缓存没清，而是 Composer 根本没“看见”你的本地目录。它只扫描 repositories 数组声明的源，不猜路径、不遍历硬盘。
常见断点：
-
repositories写错了位置：必须在主项目根composer.json的顶层字段，不能塞进require、config或本地包自己的composer.json里 -
url值用了file://、~/或绝对路径（尤其 Windows 下C:workpkg容易静默失败），应统一用相对路径，如"../packages/utils" - 本地包目录下没有
git init或至少一个commit，Composer 会直接跳过该目录，不报错也不提示 - 本地包的
composer.json缺name字段，或写了"utils"却在require里写"acme/utils"——大小写、vendor 名、斜杠，全部必须一字不差
本地包的 composer.json 要补哪些关键字段
composer init 生成的模板远远不够，Laravel 或通用 PHP 包必须手动补全才能被正确加载和自动发现。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
核心字段清单：
-
"type": "library"（通用包）或"laravel-package"（Laravel 专用，启用自动 service provider 发现） -
"autoload": {"psr-4": {"Acme\Utils\": "src/"}}——命名空间与目录映射必须一致，反斜杠要双写或用单引号包裹 -
"require": {"php": "^8.1"}——明确 PHP 版本，避免 Laravel 10+ 项目因兼容性中断构建 -
"extra": {"laravel": {"providers": ["Acme\Utils\UtilsServiceProvider"]}}——如果不用自动发现，必须显式声明 provider 类路径
漏掉 autoload 或 psr-4 映射错误，会导致类根本不会被自动加载，composer dump-autoload 也救不了。
改完本地包代码后，为什么主项目还是旧行为
最常被忽略的一点：composer install 不刷新已有 symlink，只补缺失的包；composer update 才会重新解析 path 源并重建链接。
所以流程必须是：
- 改完
../my-pkg/src/Helper.php - 在主项目根目录运行
composer update acme/utils（指定包名，避免全量更新触发意外依赖升级） - 验证链接是否更新：
ls -la vendor/acme/utils应指向最新 commit 的物理路径；Windows 下用dir vendorcmeutils看是否为“快捷方式”类型
另一个隐蔽坑：某些 IDE（如 PHPStorm）会缓存 vendor 目录下的文件内容，即使 symlink 已更新，编辑器仍显示旧代码——关掉“Always show the physical file path”或重启索引可解决。
