根本原因是Composer在中文路径或WSL的drvfs文件系统下调用PHP symlink()函数静默失败并降级为copy()，需设"config": {"bin-compat": "full", "use-symlinks": true}、COMPOSER_HOME指向英文路径，并将项目置于WSL ext4分区或补chmod +x权限。
Composer install 时 vendor 目录软链接变成普通文件？
这是 Windows + WSL 或中文路径下启用 composer install 时的典型现象：本该是符号链接（symlink）的 vendor/bin 或包内 bin 脚本，最终生成为普通文件甚至空文件。根本原因是 Composer 默认调用 PHP 的 symlink() 函数，而该函数在中文路径或某些 Windows 文件系统（如 NTFS 启用“Windows 子系统兼容性”但未配置好）下会静默失败，退化为 copy()。
如何让 Composer 强制使用 symlink 模式且不降级？
关键不是改 PHP 配置，而是控制 Composer 自身行为。它提供两个可组合的配置项：
-
COMPOSER_HOME环境变量需指向英文路径（如/home/user/composer），避免中文路径污染全局配置 - 项目根目录下创建
composer.json，显式设置："config": { "bin-compat": "full", "use-symlinks": true } - 运行时加
--no-interaction --prefer-dist避免交互式 fallback 干扰 symlink 判定
注意："use-symlinks": true 仅对 vendor/bin 和包内 bin 目录生效；对 vendor/autoload.php 这类文件无影响。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
Windows 下 WSL2 中 vendor/bin 软链接仍不可执行？
WSL2 默认挂载 Windows 分区时使用 drvfs，该文件系统不支持 Unix 权限和 symlink —— 即使 ls -l 显示 ->，实际是 Windows 的“重解析点”，PHP 的 is_executable() 会返回 false。解决路径只有两个：
- 把项目放在 WSL2 原生 ext4 分区（如
/home/xxx/project），而非/mnt/c/xxx - 若必须放 Windows 盘，改用
bin-compat: full+ 手动补权限：chmod +x vendor/bin/* 2>/dev/null || true
（注意这仅临时有效，每次composer install后需重跑）
中文路径下 composer dump-autoload 报错 “failed to open dir”？
这不是 autoload 本身的问题，而是 Composer 在扫描 vendor 时调用了 scandir()，而 PHP 7.4+ 对 UTF-8 路径支持不一致（尤其在非 UTF-8 locale 下）。验证方式：locale 输出是否含 UTF-8。修复方法：
- Linux/WSL：启动前执行
export LANG=en_US.UTF-8（写入~/.bashrc更稳妥） - Windows CMD/PowerShell：无需改 locale，但需确保终端编码为 UTF-8（
chcp 65001），且composer.json文件本身保存为 UTF-8 无 BOM - 跳过扫描中文目录：在
composer.json的autoload段中，用exclude-from-classmap排除含中文名的第三方包目录（如有）
软链接失效背后，真正卡住人的往往不是 symlink 本身，而是路径编码、文件系统语义、PHP 运行时 locale 三者没对齐。一个中文字符，可能同时触发 Windows 路径解析、NTFS 元数据、PHP 内部字符串处理三层隐式转换 —— 改配置不如先统一环境编码基线。
