npm link原理是通过在全局node_modules创建符号链接指向本地包，再在项目中用npm link 建立项目node_modules到该全局链接的符号链接，实现本地开发调试。
直接结论：用 repositories 配 {"type":"path","url":"../my-package"}，不是往 require 里写路径；改了本地包代码不生效？默认是复制，得加 "options": {"symlink": true} 并执行 composer update vendor/name。
为什么 composer require vendor/name:dev-main 报 “Could not find package”
根本原因不是网络或权限，而是 Composer 根本没“看见”你的本地目录。它只在主项目 composer.json 的 repositories 数组里找源，require 字段只声明“我要哪个包”，不负责“去哪找”。
-
repositories必须写在主项目（即你正在开发的那个项目的）composer.json里，不能写在本地包自己的composer.json中 -
url必须是相对路径（如"../my-package"），绝对路径在 Windows 上极易静默失败（盘符、反斜杠、空格都会中断） - 本地包目录下必须有合法的
composer.json，且其中name字段（如"acme/utils"）要和require里写的完全一致（大小写敏感） - 版本约束必须用
dev-main、dev-develop这类分支名，不能写1.0.0——path源下 Composer 忽略version字段，只认当前 Git HEAD 所在分支
怎么让改完本地包代码立刻在主项目里生效
默认行为是复制（copy），不是链接（symlink）。这意味着你改了 ../my-package/src/Helper.php，vendor/acme/utils/Helper.php 还是旧文件。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须显式启用符号链接：在主项目
composer.json的repositories条目里加"options": {"symlink": true}，或在本地包自己的composer.json里加同样字段（效果等价） - 执行
composer update acme/utils（不是dump-autoload），才会重建 symlink - 验证是否成功：
ls -la vendor/acme/utils应显示箭头指向源目录；Windows 用户用dir vendor\acme\utils看是否为“快捷方式”类型 - Windows 需开启开发者模式或以管理员权限运行命令行，否则 symlink 创建会失败且无提示
生产部署时 path 仓库为什么报错
因为 path 类型仓库是开发专用机制，它不回退、不 fallback。生产服务器上不存在 ../my-package 路径，Composer 就直接失败，不会自动切到 Packagist。
- 别把含
path的repositories提交到 git —— 它只该存在于你本地的composer.json或通过构建脚本动态注入 - 推荐用
Studio工具管理本地覆盖：它不修改composer.json，而是临时生效，天然规避部署污染 - 若必须用
path，CI/CD 流程中应在安装依赖前移除该配置，例如用composer config --unset repositories.0（假设它是第一个 repo） - 绝对不要在
composer.json中保留"type": "path"同时又配了"packagist.org"—— 这会导致行为不可控，尤其当本地路径意外存在时
最易被忽略的一点：path 仓库跳过所有元数据请求，不查 packages.json，不连 Packagist，也不走语义化版本解析逻辑。它只是读取本地 composer.json 内容并硬装。一旦路径错、name 错、分支名错，错误信息极其简陋，排查时容易陷入“明明写了却找不到”的死循环。
