Composer日志出现“symlinking”仅表示尝试创建符号链接，不代表成功；必须验证文件系统是否真有→符号（Linux/macOS）或JUNCTION（Windows），且composer.lock中"source.type"为"path"。
Composer path 仓库启用 symlink 后，composer update 输出里出现 symlinking 字样，不代表链接已成功创建——它只是表示“Composer 尝试了 symlink 操作”，成败需人工验证。
为什么看到 “symlinking” 却没生成软链？
这是最常被误解的点。Composer 在日志中打印 symlinking，仅说明它走到了 symlink 创建逻辑分支，但不保证系统层面真正建出符号链接。失败时通常静默 fallback 到 copy 模式，且不报错、不警告。
- Windows 用户未以管理员身份运行终端，或未开启“开发者模式” → symlink 创建被系统拒绝，Composer 自动降级为复制文件
- Docker 容器未加
--cap-add=SYS_ADMIN，或挂载方式不支持 symlink（如某些 NFS 或 bind mount 场景） - 本地包自己的
composer.json根级缺少"options": {"symlink": true}—— 主项目配置"symlink": true在 Composer ≥2.2 中已被忽略，必须由本地包声明 - 目标路径存在同名目录（如
vendor/vendor/name已是普通文件夹），Composer 不会覆盖，直接跳过链接步骤
如何确认 symlink 是否真实生效？
别信日志，看文件系统。运行命令后必须手动检查：
- Linux/macOS：
ls -la vendor/vendor/name，输出中必须含->符号，例如vendor/name -> ../../my-local-pkg - Windows：
dir vendor\vendor\name，应看到JUNCTION标识；若显示为普通目录，就是 fallback 成了 copy - 顺手打开
composer.lock，搜索该包，确认"source": {"type": "path"}，而非"type": "git"或"dist"
symlinking 日志出现在哪些命令里？
symlinking 只会在明确触发仓库重解析的命令中出现，且只对 path 类型仓库有效：
-
composer update vendor/name—— 推荐，精准重建链接，不扰动其他依赖 -
composer update（无参数）—— 全量重算，慢，可能意外升级其他包 -
composer require vendor/name:dev-main—— 首次引入时会触发 symlink 创建 -
composer install永远不会打印symlinking，它只按composer.lock还原，完全跳过 symlink 流程
真正关键的不是日志有没有“symlinking”三个字，而是你是否在本地包的 composer.json 里写了 "options": {"symlink": true}，以及你是否用 update 而非 install 来驱动它。漏掉任一环，就只剩一个看起来很忙、实际没干活的日志行。
