composer clear-cache 不处理软链接，因它仅清理 files/、repo/、vcs/ 子目录下的真实文件，对缓存根目录中任何 ln -s 创建的软链接既不检查也不删除；此类链接需手动识别并安全移除。
composer clear-cache 为什么删不掉软链接
它根本不管软链接。composer clear-cache 只清 files/、repo/、vcs/ 三个子目录下的真实文件和目录，对缓存根目录里任何 ln -s 创建的软链接完全无视——既不检查，也不删除。
常见场景是：你手动把 ~/.composer/cache 软链接到 NAS 或 SSD 分区（比如 ln -s /mnt/ssd/composer-cache ~/.composer/cache），升级或 CI 构建后残留了旧链接；或者某些私有镜像工具（如 composer-mirror）在缓存目录下生成指向临时路径的软链接，clear-cache 执行完，它们还在那儿。
- 软链接本身不占磁盘空间，但可能指向已失效路径，导致后续
composer install报No such file or directory -
ls -la ~/.composer/cache能一眼看出哪些是->结尾的软链接 - 别用
rm -rf ~/.composer/cache直接删整个目录——如果它是软链接，实际删的是目标路径，不是链接本身 - 正确删链接：先
rm ~/.composer/cache（只删链接文件），再按需重建或让 Composer 自动初始化
如何安全清理项目级 vendor 中的软链接
这不是 Composer 缓存的事，而是项目 vendor/ 目录里混入了人为或脚本创建的软链接（比如为调试 symlinked package 临时加的，或 IDE 自动生成的符号引用）。这类链接不会被 composer install 或 clear-cache 处理，但可能干扰自动加载或部署。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确认是否存在：
find vendor -type l -ls（Linux/macOS）或dir /s /a:l vendor\（Windows CMD） - 只删明确废弃的链接：比如指向已删除源码目录的
vendor/my/package -> /tmp/old-src - 别批量
rm -f $(find vendor -type l)——有些包（如hirak/prestissimo插件）依赖软链接机制，误删会导致composer update失败 - 更稳妥做法：删
vendor/后重新composer install，让 Composer 完全接管依赖结构
镜像源缓存（如阿里云、腾讯云）里的软链接怎么处理
私有镜像服务（尤其是自建 Nexus、Artifactory 或腾讯云 TKE 镜像）有时会在响应中返回软链接式重定向（HTTP 302 + X-Accel-Redirect），或本地镜像代理层用软链接组织存储路径。这些不在 Composer 本地缓存控制范围内，clear-cache 无效。
- 确认是否是镜像问题：运行
composer config repo.packagist，看是否为false且指向类似https://mirrors.aliyun.com/composer/的地址 - 清镜像侧缓存需走对应平台操作：阿里云镜像无用户级清理入口，只能等 TTL 过期（通常 24 小时）；腾讯云 TKE 镜像支持 API 清单刷新
- 临时绕过：加
--no-cache强制直连源站（慎用，可能触发限流）或切回官方源验证：composer config repo.packagist https://packagist.org - 软链接若出现在镜像服务器的文件系统上（如
/var/www/mirror/packagist/2025/06/xxx -> ../2025/05/xxx），必须登录服务器手动处理，Composer 命令完全不可见
清理前必须检查的三个硬性条件
软链接问题往往暴露的是更底层的权限或配置错位，直接删可能掩盖真因。
- 执行
composer config --global cache-dir，确认输出路径和你认为的“缓存位置”一致——如果显示/mnt/nfs/composer-cache，那~/.composer/cache下的软链接就是冗余残留 - 运行
lsof +D $(composer config --global cache-dir) 2>/dev/null | grep -q composer（Linux/macOS），确保没后台composer进程正读写缓存目录，否则删软链接可能触发Corrupted cache file - CI/CD 环境中，检查是否用了
COMPOSER_CACHE_DIR环境变量覆盖路径——如果变量值是/tmp/composer-cache，但你的软链接还挂在~/.composer/cache，那就是配置未生效，该修的是 CI 脚本，不是删链接
软链接本身轻量，但它的存在常常意味着某次手动干预或自动化脚本偏离了 Composer 的标准路径约定。处理时优先还原标准行为，而不是修补表象。
