composer默认不走symlink是因为path仓库采用硬拷贝以保证可重现性；需在根项目composer.json的config中设"symlink": true，并配type为path的repository，windows需管理员权限。
为什么 composer install 不走 symlink？
默认情况下，Composer 安装包时会从仓库下载 ZIP 或通过 Git 克隆，即使你在 composer.json 中用 "path" 类型配置了本地路径，它也不会自动创建 symlink —— 除非你显式启用 symlink 模式。常见现象是：改了本地包代码，vendor/ 里的文件没变，composer update 后还是旧逻辑。
根本原因是 Composer 的 path repository 默认使用“硬拷贝”（copy），这是为了保证可重现性和 CI 环境兼容性。要让它走 symlink，必须在 config 中设置 "symlink": true，且该配置需位于根项目（即你运行 composer install 的那个项目的）composer.json 中。
-
"type": "path"必须和"url"配合使用，"url"是本地绝对路径或相对路径（推荐相对路径，如../my-local-package） -
"symlink": true必须放在"config"下，不是 repository 里，也不是全局 config - Windows 用户注意：需要管理员权限或启用开发者模式才能创建 symlink，否则会 fallback 到 copy 并静默提示
如何正确配置 path repository + symlink
假设你有个本地包在 ../laravel-utils，结构合规（含 composer.json，"name" 为 acme/laravel-utils），你想在当前项目中以 symlink 方式引用它：
{
"repositories": [
{
"type": "path",
"url": "../laravel-utils"
}
],
"require": {
"acme/laravel-utils": "*"
},
"config": {
"symlink": true
}
}
执行 composer update acme/laravel-utils 后，vendor/acme/laravel-utils 就会是一个指向 ../laravel-utils 的符号链接（Linux/macOS）或目录联结（Windows junction，若权限允许）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要把
"symlink": true放进repositories数组内部 —— 这无效 - 如果本地包的
composer.json中"version"是dev-main，则require中也得写"dev-main"，否则匹配失败 -
composer dump-autoload通常不需要手动执行，但如果你改了本地包的类名或命名空间，记得运行它
symlink 失败后怎么查原因？
最常遇到的是 “Could not create symlink” 错误，或没有报错但实际仍是 copy。先确认三件事：
- 运行
composer config --list | grep symlink，输出应包含config.symlink=true；若为空，说明配置未生效 - 检查本地包路径是否真实存在、有读取权限，且
composer.json中"name"和require中的包名完全一致（包括大小写） - Windows 下执行
cmd看是否提示 “You do not have sufficient privilege”，此时需以管理员身份运行终端，或改用mklink /D手动建 junction 后删掉vendor/再重试 - 执行
composer update -v（verbose 模式），观察日志里是否出现Creating symlink或Copying from—— 后者说明 fallback 到了 copy
symlink 模式下要注意什么？
symlink 让开发调试变快，但也引入几个隐性约束：
- 本地包的
vendor/不会被加载 —— Composer 只解析根项目的autoload，所以本地包若有私有依赖，得确保它们也在根项目中声明或已安装 - Git 提交时，
vendor/下的 symlink 会被当作普通文件记录（Linux/macOS 是120000类型 blob），CI 环境拉取后无法还原，因此path + symlink仅限开发环境，CI 应用正式仓库地址 - IDE（如 PHPStorm）可能无法自动识别 symlink 后的类跳转，需手动在
Settings > Directories中标记本地包路径为 “Sources” - 修改本地包的
composer.json（比如加了个autoload规则），必须重新运行composer update，否则根项目的 autoloader 不会更新
真正麻烦的往往不是配置本身，而是团队成员忘了关掉 symlink 就提交了 composer.lock，或者在 CI 脚本里漏掉了对 path repository 的清理 —— 这些细节比命令本身更耗时间。
