必须启用windows longpathsenabled注册表项并重启终端，否则autoload_static.php中硬编码的绝对路径超260字符会直接被系统拦截；需关闭classmap-authoritative模式、将项目移至短路径（如d:\p\myapp）、避免同步目录及中文路径。
autoload_static.php 里硬编码的绝对路径会直接触发 MAX_PATH 限制
Composer 自动生成的 vendor/composer/autoload_static.php 和 autoload_classmap.php 文件，会在内部写死完整绝对路径（比如 C:\Users\Alice\Projects\MyApp\vendor\monolog\monolog\src\Monolog\Logger.php）。Windows 在执行 file_exists() 或 include() 时，会直接校验该路径长度，一旦超过 260 字符，就静默失败或报 The filename or extension is too long。
这不是自动加载逻辑出错，而是系统级拦截——PHP 进程本身没机会解析或 fallback，路径在进入 PHP 前就被内核拒绝。
- 必须先启用 Windows 的
LongPathsEnabled注册表项（DWORD 值为 1），否则任何后续操作都只是临时绕路 - 启用后仍需重启所有终端（CMD/PowerShell/Git Bash）和 IDE，旧进程不会继承新策略
- PHP 版本需 ≥7.4，Composer 版本需 ≥2.2，二者都需声明长路径兼容性（通过 manifest 或编译标志）
classmap-authoritative 模式是 Windows 上路径爆炸的主因
Composer 2.2+ 默认开启 classmap-authoritative，它会递归扫描整个 vendor/ 目录（包括 tests/、examples/、_files/ 等非生产路径），把每个 PHP 文件的绝对路径塞进 autoload_classmap.php。哪怕一个包里有 tests/fixtures/deep/nested/structure.php，也会被拼进去，极易突破 260 字符。
直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集，阿里云 ASR 实时识别。一键启动脚本，自动安装环境。
- 全局关闭：运行
composer config -g classmap-authoritative false - 项目级关闭：运行
composer config classmap-authoritative false - 删掉旧缓存文件：
rm vendor/composer/autoload_classmap.php（或手动删除） - 再执行
composer dump-autoload，此时只基于 PSR-4/PSR-0 规则映射，不扫全盘
vendor-dir 缩短路径名不能解决 autoload_static.php 中的路径问题
把 vendor-dir 设成 "v" 或 "D:/v"，只改了目录名或顶层位置，但 autoload_static.php 里生成的仍是完整绝对路径——它由当前工作目录 + vendor/ 下实际文件路径拼接而来，不是相对引用。
-
composer config vendor-dir "v"只让 vendor 落在项目内，基础路径越长，生成的绝对路径就越危险 -
composer config vendor-dir "D:/v"确实能减少前缀长度，但无法规避包内部深度嵌套（如phpunit/phpunit的tests/_files/...） - 真正有效的做法是：把项目根目录移到极短路径下，例如
D:\p\myapp，而非C:\Users\Name\Documents\GitHub\myapp - 避免放在 OneDrive / Google Drive 同步目录中——它们会在路径前加虚拟挂载前缀，额外增加 30+ 字符
临时绕过 autoload 生成阶段可快速恢复安装流程
有些项目在 composer install 初期就因生成 autoload 文件失败而中断，此时可跳过该阶段，等 vendor 解压完成后再单独处理。
- 先运行
composer install --no-scripts --no-plugins，强制跳过 autoload dump 和插件初始化 - 确认
vendor/已存在且结构完整后，再运行composer dump-autoload - 如果仍失败，说明路径问题尚未解除，应优先检查
LongPathsEnabled是否生效、是否重启终端 - 不要长期依赖
--no-scripts，它可能跳过必要的 post-install-cmd 脚本（如生成配置、清理缓存）
LongPathsEnabled 没开、开了没重启、开了但 PHP 进程没加载新策略。所有路径优化手段，都建立在这个前提之上。
