高效热更新需确保 symlink 真实生效、本地包含合法 composer.json（name 与 require 严格一致）、repositories 正确配置在主项目根级，且 git 已初始化；否则改代码无反应却无报错。

能直接 symlink 热更新、改代码不重装、require 不用反复改，才算高效；否则就是徒增配置负担。

本地包的 composer.json 必须合法且 name 对齐

Composer 不会报错跳过非法或不匹配的本地包，而是静默忽略——这是“Could not find package”最常见原因。

• 本地包根目录下必须存在 composer.json，且至少包含 "name" 字段（如 "acme/utils"），值要和主项目 require 中写的完全一致（大小写敏感）
• "version" 字段非必需，但若省略，主项目需设 "minimum-stability": "dev"，否则 "dev-main" 这类分支名会被稳定性策略过滤掉
• 如果本地包没初始化 Git，可手动加 "version": "dev-main"，否则 Composer 无法推断分支版本
• 别把 repositories 写进本地包自己的 composer.json——它只影响自身安装，主项目根本看不到

主项目 composer.json 的 repositories 要写对位置和格式

配置写错位置或格式，Composer 就当它不存在，连 warning 都不给。

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" 数组里，不能嵌套在 require 或其他字段中
• "type" 必须是 "path"，不是 "package" 或 "vcs"
• "url" 必须是相对于主项目 composer.json 的路径，如 "../acme-utils" 或 "./packages/my-pkg"；~/、$HOME/、file://、绝对路径均无效
• 整个 repositories 是数组，哪怕只配一个，也要写成 [{ "type": "path", "url": "./packages/my-pkg" }]

确保 symlink 生效，否则改代码不生效

默认启用 symlink，但 Windows 和权限受限环境极易 fallback 到 copy 模式，且不提示。

• 验证是否真用了链接：ls -l vendor/acme/utils（macOS/Linux）或 dir vendor\acme\utils（Windows），看到 -> 或 <symlinkd></symlinkd> 才对
• Windows 下需以管理员身份运行终端，或开启“开发者模式”，否则无法创建符号链接
• 检查主项目 composer.json 是否有 "config": {"symlinks": false} —— 显式关闭会强制复制
• 本地包目录若被 OneDrive、WSL 跨文件系统挂载或 NTFS 权限限制，Composer 可能静默退回到 copy 模式
• 本地包必须已执行 git init && git add . && git commit -m "init"，否则 Composer 拒绝 symlink

多包联调时用全局 repositories 省事

同时调试 acme/utils、acme/api-client、acme/logger 时，每个项目重复写 repositories 很累。

• 用 Composer 全局配置一次：composer config -g repositories.acme-path '{"type":"path","url":"~/dev/acme/*"}'
• url 支持 * 通配符，自动匹配 ~/dev/acme/ 下所有含合法 composer.json 的子目录
• 全局配置后，各项目只需 require 包名，无需再声明 repositories
• 注意：全局配置不解决 symlink 权限问题，Windows 下仍需管理员权限或开发者模式

真正卡住的点往往不在配置本身，而在 symlink 是否真实建立、Git 初始化是否完成、路径是否被 OneDrive 同步锁定——这些地方一出问题，现象都是“改了代码没反应”，但错误信息为零。