直接结论：统一用正斜杠/，php 7.4+自动适配windows；路径需去重冗余，避免双分隔符；vendor-dir等跨平台字段禁用反斜杠和环境变量；scripts中优先调用php脚本而非shell命令。
直接结论：别手动拼 或 /，统一用正斜杠 /，PHP 7.4+ 会自动转义适配 Windows；但凡涉及 fopen、include、file_get_contents 的路径，必须确保末尾不重复、开头不冗余。
为什么 / 在 Windows 上也能用？
Windows API 从 NT 开始就支持正斜杠 / 作为路径分隔符（比如 C:/Users/name/file.txt），PHP 内部调用系统接口时会自动转换。这不是“凑巧能用”，而是底层兼容设计——所以硬写 / 比动态拼 DIRECTORY_SEPARATOR 更可靠、更少出错。
- 写
"C:/data/config.json"安全；写"C:dataconfig.json"要逃逸成"C:\data\config.json"，易漏、难读 -
DIRECTORY_SEPARATOR看似“严谨”，但容易和已有路径末尾的分隔符叠加，导致C:path\file这种双反斜杠错误 - Composer 自动加载器本身不解析路径分隔符，它只管把类名映射到文件路径字符串——只要 PHP 能
include进去，就 OK
composer.json 里的 vendor-dir 怎么写才跨平台？
这个字段是纯字符串，Composer 不做路径标准化。写错分隔符会导致 Windows 下创建目录失败，或 Linux 下误建名为 vendor-dir 的子目录。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确写法：
"vendor-dir": "v"（相对路径）或"vendor-dir": "C:/v"（绝对路径，用/） - 错误写法：
"vendor-dir": "C: "—— Windows cmd 会把 - 绝对路径慎用：跨机器部署时，
C:/v在别人电脑上可能根本不存在；优先用相对路径 +mklink/ln -s映射短路径 - 别在
vendor-dir里用环境变量如${HOME}/v—— Composer 不展开 shell 变量
scripts 字段执行失败？不是语法问题，是分隔符混入了 shell 命令
composer.json 的 scripts 是直接交给系统 shell 执行的。Windows 用 cmd.exe，Linux/macOS 用 bash，它们对路径分隔符、命令语法完全不兼容。
- 写
"post-install-cmd": "cp ./config/example.php ./config/app.php"→ Linux OK，Windows 直接报'cp' 不是内部或外部命令 - 写
"post-install-cmd": "php ./scripts/init.php"→ OK，因为php是跨平台命令，且路径用/被 PHP 自动处理 - 真正安全的做法：把复杂逻辑抽到 PHP 脚本里，用
copy()、rename()等函数操作路径，再在scripts中调用该脚本 - 如果非要用 shell 命令，Windows 下改用
copy、del、mkdir，Linux 下用cp、rm、mkdir -p，但得拆成两个 script 条目，靠php -r "echo PHP_OS_FAMILY;"判断后触发
全局 bin 目录路径差异影响命令调用
Composer 全局安装的命令（如 laravel/installer）最终落在不同位置，PATH 配置不对就找不到可执行文件。
- Linux/macOS 默认在
$HOME/.composer/vendor/bin，要确保该路径在$PATH中（检查echo $PATH） - Windows 默认在
%APPDATA%Composer endorin，需手动加进系统 PATH（不是用户 PATH，某些终端不读用户级变量） - 验证方式：运行
composer global config bin-dir --absolute，输出路径必须真实存在且含可执行文件 - 常见坑：Windows 家庭版用户改了注册表启用长路径，但没重启——
composer global require装的命令在 CMD/PowerShell 里仍不可见
最麻烦的不是分隔符本身，而是路径拼接时的边界情况：开头有没有盘符、末尾有没有分隔符、是否已含协议前缀（如 phar://）。这些地方一错，include 就静默失败，fopen 报 No such file 却不告诉你哪段错了。建议所有路径构造都走 realpath() 或 str_replace('\', '/', $path) 统一归一化，再传给文件操作函数。
