Laravel 11在Win10/11安装报错主因是PHP版本（需8.2.2或8.3.22，禁用8.4.x）、阿里镜像源过滤dev包、权限不足（须管理员运行+关杀软）、路径含中文/空格，以及漏执行.env复制和key:generate。
Win10/11 安装 Laravel 11 报错，90% 不是框架问题，而是本地环境链路中某一个环节没对齐。核心矛盾集中在 PHP 版本、Composer 镜像源、权限控制和路径规范这四点上。下面直击关键场景，不绕弯。
PHP 版本必须 ≥ 8.2，且不能是 8.4.x（尤其 8.4.8）
Laravel 11 官方要求 PHP ≥ 8.2，但实际安装中，PHP 8.4.x（如 8.4.8）会触发依赖解析异常——部分包（如 fruitcake/php-cors）在 8.4 下的 Composer 行为与预设 stability 策略冲突，导致“does not match your minimum-stability”类报错。这不是 Laravel 本身不兼容，而是当前生态尚未完全适配 PHP 8.4 的新特性。
- 推荐使用 PHP 8.2.2 或 8.3.22（已验证稳定）
- 下载 ZIP 包解压即可，无需安装服务；路径避免中文、空格、括号（如 D:\php82 比 C:\Program Files\php 更稳妥）
- 配置系统环境变量 Path，添加该 PHP 目录，并在 CMD 中执行 php -v 和 php -m | findstr "openssl curl mbstring" 确认关键扩展已启用
阿里云 Composer 镜像源是常见“静默故障源”
阿里镜像在同步过程中会对 dev 分支、-dev 后缀或 unstable 标签的包做过滤，而 Laravel 11 安装时依赖的 laravel/tinker ^2.10.1、fruitcake/php-cors ^1.3 等包，在某些时间点仅以 dev-master 或 1.3.x-dev 形式存在于 packagist.org，阿里镜像未同步或拒绝返回，就会报“found but does not match your minimum-stability”。
- 临时切回官方源：运行 composer config -g repo.packagist composer https://packagist.org
- 或换用腾讯镜像（更及时）：composer config -g repos.packagist composer https://mirrors.tencent.com/composer/
- 如需保留阿里源，可先取消：composer config -g --unset repos.packagist，装完再恢复
必须以管理员身份运行命令行 + 关闭杀软实时监控
Windows 下 Composer 创建项目会写入大量 vendor 文件、生成缓存、调用 git clone，若权限不足，轻则报 “failed to open stream: Permission denied”，重则卡死或静默失败；部分安全软件（尤其带“勒索防护”功能的）会拦截 composer 对 vendor 目录的批量写入。
- 右键“Windows PowerShell（管理员）”或“CMD（管理员）”，再执行 composer create-project laravel/laravel myapp
- 安装前临时关闭 Windows Defender 实时保护，或把项目目录加入排除列表
- 不要在 OneDrive、iCloud 或 WSL 虚拟路径下初始化项目（路径映射易出错）
别跳过 .env 和 key:generate 这两步
很多“页面空白”“500 错误”“No application encryption key”其实不是安装失败，而是项目跑起来了但没完成初始化：
- 进入项目目录后，先复制 .env.example → .env
- 执行 php artisan key:generate（确保 APP_KEY 写入 .env）
- 确认 storage/logs 和 storage/framework/cache 权限：右键文件夹 → 属性 → 安全 → 编辑 → 给当前用户“完全控制”
- 启动服务：php artisan serve，默认访问 http://127.0.0.1:8000，不要直接双击 index.php
不复杂但容易忽略。
