laravel在wsl跨磁盘目录（如/mnt/c/）安装会因ntfs不支持unix权限、符号链接及大小写敏感导致storage:link失败、composer异常、i/o卡顿等问题；应始终将项目置于wsl原生路径（如/home/username/projects/）以确保功能正常。
在 WSL（Windows Subsystem for Linux）中跨磁盘目录（比如从 /mnt/c/Users/xxx 这类挂载的 Windows 盘符路径）安装 Laravel，会引发一系列实际运行问题，核心原因是 WSL 对 Windows 挂载点（/mnt/c, /mnt/d 等）的文件系统支持不完整。
文件权限与符号链接失效
WSL 默认以 Linux 权限模型运行，但 /mnt/c 下的文件由 Windows NTFS 管理，不支持原生 Unix 权限（如 chmod、chown）和符号链接（symlink）。Laravel 安装过程依赖：
-
php artisan storage:link创建指向storage/app/public的符号链接 —— 在/mnt/c/...下执行会失败或生成无效链接； -
composer install中某些包（如laravel/sail）需写入可执行脚本或创建软链 —— 权限拒绝或 silently ignored； - 缓存、日志、session 等写入操作可能因 NTFS 不识别
umask或 ACL 而报错（如file_put_contents(): failed to open stream: Permission denied）。
性能严重下降与 I/O 错误
跨磁盘访问本质是通过 WSL 的 9P 协议桥接 Windows 文件系统，I/O 延迟高、吞吐低。表现包括：
- Composer 安装依赖极慢，甚至超时中断；
- Artisan 命令（如
optimize:clear、migrate）响应卡顿，偶尔抛出Input/output error； - Sail 启动容器时，挂载
/mnt/c/.../app作为卷，Docker Desktop 可能报invalid mount config或容器内文件不可见。
Git 与 Composer 行为异常
NTFS 不区分大小写，且默认禁用 Linux 扩展属性：
- Git 在
/mnt/c下可能忽略文件名大小写变更（如Foo.php→foo.php），导致 Laravel 类自动加载失败； - Composer 的
vendor目录若含大小写敏感路径（常见于第三方包），会加载错误或报Class not found； -
composer.lock中记录的哈希值可能因文件系统元数据差异而校验失败。
推荐做法：始终在 WSL 原生文件系统操作
把项目放在 WSL 的根文件系统下（如 /home/username/projects/my-app），再通过 VS Code Remote-WSL 或 Windows Terminal 访问。这样可确保：
- 完整支持符号链接、权限控制、POSIX 文件操作；
- Composer 和 Artisan 运行稳定，无 I/O 异常；
- Sail 容器挂载路径可靠，日志、缓存、存储均正常写入；
- Git 行为符合预期，避免大小写或换行符干扰。
若必须从 Windows 路径启动项目，建议仅用作只读参考，实际开发、安装、运行全部切换至 WSL 内部路径。
