根本原因是代码或依赖中隐式假设了操作系统特性：ext-posix硬依赖、路径拼接混用斜杠、bin脚本未适配PATH查找逻辑、composer.lock含绝对路径，需通过realpath()校验、--platform参数重解析、移除硬编码系统命令等方式切断隐式假设。
ext-posix 缺失、bin 脚本执行失败、路径拼接出错、composer.lock 在 Windows 上生成后 Linux 部署报 failed to open stream——这些不是 Composer 故意“不兼容”，而是你没切断对操作系统的隐式假设。
为什么 ext-posix 报错却在 Linux 下没事？
这不是 Windows 的问题，是某个依赖（比如旧版 symfony/console 或某些 CLI 工具）在 require 里硬写了 "ext-posix": "*"。Windows 没这个扩展，Composer 就卡住不装。
- 先查谁加的：
composer show --tree | grep posix - 如果只是本地开发用（比如跑测试），把它挪到
require-dev更合理 - 必须运行时用？改代码，用
if (function_exists('posix_getpid')) { ... }替代直接调用 - 临时绕过可加
--ignore-platform-req=ext-posix，但别提交进 CI，也别当成最终解
为什么 vendor/bin/mytool 在 Windows 下提示“不是内部或外部命令”？
bin-compat 设成 full 后，Composer 确实会生成 mytool.bat，但 Windows 命令行默认只认 .exe、.bat、.cmd，且要能被 PATH 找到。
直播间话术巡检-windows
下载
直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集，阿里云 ASR 实时识别。一键启动脚本，自动安装环境。
- 确认你执行的是
vendor\bin\mytool.bat，不是vendor\bin\mytool（后者在 cmd/powershell 里不可执行） - 检查
bin-dir路径是否含空格或中文——会导致 .bat 生成语法错误（如was unexpected at this time） - Git Bash / WSL 不认
.bat，此时应设bin-compat=symlink并在 WSL 里用vendor/bin/mytool - IDE 终端（如 PhpStorm）可能没刷新 PATH，重启终端或手动运行
refreshenv
为什么 __DIR__ . '/../src' 在 Windows 下有时 require 失败？
PHP 7.4+ 支持正斜杠 /，但拼出来的路径若混入反斜杠（比如 WSL 挂载或 CI 挂载路径异常），file_exists() 可能静默返回 false，哪怕文件真实存在。
- 所有
composer.json中路径字段（autoload、scripts）必须统一用/，禁用\和DIRECTORY_SEPARATOR - 代码中路径拼接优先走：
realpath(__DIR__ . '/../src')或dirname(__DIR__) . DIRECTORY_SEPARATOR . 'src' - 别依赖
__DIR__拼完直接require；先realpath()包一层再判断 - 离线部署前，必须在目标系统（Linux）上执行
composer install --no-dev --optimize-autoloader，否则autoload_classmap.php里可能残留C:\project\src这种绝对路径
为什么改了 config.platform 却没效果？
platform 是给 Composer 解析依赖用的“编译期快照”，它不改当前 PHP 版本，也不影响运行时。改了配置却不生效，90% 是因为没触发重新解析。
-
composer install严格按composer.lock还原，完全无视当前platform设置 - 改完
config.platform后，必须删掉composer.lock和vendor/，再跑composer update --lock - CI 流水线里，确保
composer.lock是用目标平台（如 PHP 8.1 + ext-opcache）生成的，而不是开发者本地的 macOS + PHP 8.2 - 临时验证优先用命令行参数：
composer install --platform=php:8.1.10（Composer ≥ 2.2），避免污染项目配置
bin-compat 或 platform，而在于你有没有在某一行 exec('ls')、某一个 '/tmp/cache'、某一次没过 realpath() 的路径拼接里，悄悄把操作系统写死了。 
