中文路径会导致composer后续命令报错、autoload失效甚至php解析失败，因其底层依赖（如curl、zip扩展）在部分系统下对非ascii路径解析不稳定，引发删除失败、类扫描丢失及缓存污染等问题。
Composer 安装失败后残留中文路径（如 vendor 或 composer.lock 所在目录含中文），会导致后续命令报错、autoload 失效甚至 PHP 解析失败——这不是编码问题，而是 Composer 在部分系统（尤其是 Windows + PHP 8+ 或 macOS 默认 UTF-8 locale）下对非 ASCII 路径的解析/缓存行为不稳定。
为什么中文路径会让 Composer 卡死或静默失败
Composer 本身支持 UTF-8 路径，但它的底层依赖（如 cURL、zip 扩展、临时解压逻辑）在某些 PHP 版本或扩展配置下会把中文路径转义成乱码或截断，导致：
• composer install 报 Could not delete vendor/autoload.php（实际是路径 decode 失败）
• composer dump-autoload 找不到类，因为扫描路径被误判为空
• 缓存目录（~/.composer/cache）里存了带 URL 编码的包路径，重装时复用损坏快照
删掉所有含中文的残留路径，不只删 vendor
不能只删 vendor 目录——Composer 的“中文污染”会扩散到多个位置：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 项目根目录：检查
composer.json和composer.lock是否在中文路径下（如/Users/张三/my-project/）。若在，直接将整个项目移到纯英文路径（如~/projects/my-project），再操作 - 全局缓存：运行
composer clear-cache后，手动确认缓存目录是否含中文字符。Linux/macOS 查ls -la ~/.composer/cache；Windows 查%APPDATA%ComposerCache。如有，删掉整个cache目录（不是清空，是删目录） - 临时目录：PHP 默认用
/tmp，但某些安装脚本会把临时文件写进当前路径。执行php -i | grep "sys_temp_dir"看输出，如果值是中文路径（如C:用户张三AppDataLocalTemp），需临时改环境变量：set TMPDIR=C: emp（Windows CMD）或export TMPDIR=/tmp（macOS/Linux） - 别忽略
~/.composer/config.json：打开它，搜"cache-dir"或"data-dir"字段，如果值是中文路径（如"C:\Users\张三\Composer"），手动改成英文路径，或干脆删掉该字段让 Composer 用默认值
重新初始化前必须绕过旧缓存和 autoload 干扰
即使路径已全英文，残留的 autoload 映射仍可能引用旧中文路径下的类。此时不能直接 composer init：
- 先删光项目内所有 Composer 产物：
rm -rf vendor composer.lock（Windows 用rmdir /s vendor & del composer.lock） - 强制禁用插件白名单（尤其 Drupal 或 Laravel 项目常见）：
composer config --no-plugins，避免插件因路径问题触发 fallback 错误 - 生成新
composer.json时加--no-interaction参数：composer init --no-interaction --name="my/project" --description="..." --require="php:>=8.1"，跳过交互式输入，防止终端编码干扰 - 首次
composer install必须带--no-cache：composer install --no-cache，否则 Composer 可能从损坏缓存中加载旧包并复现路径错误
验证是否真干净：看 autoload.php 和 vendor/bin 是否可执行
成功后，检查两件事：
-
vendor/autoload.php文件存在且开头是标准 PHP tag（<?php），不是空文件或乱码 - 执行
php -f vendor/autoload.php不报错；再跑php -r "require 'vendor/autoload.php'; echo class_exists('Composer\Autoload\ClassLoader') ? 'OK' : 'FAIL';"输出OK - 如果项目含 bin 脚本（如
vendor/bin/drush或vendor/bin/phpunit），确保它们有执行权限（Linux/macOS 运行chmod +x vendor/bin/*）
中文路径残留最难察觉的点在于：它可能不报错，只是 autoload 扫描漏掉某些目录，导致 class not found。所以不要只信 composer install 成功就完事，必须验证 autoload 实际加载效果。
