必须先运行php -v和php -m验证php≥8.1及mbstring、openssl、pdo等核心扩展；再确保composer≥2.5、换国内镜像源、用^10.0锁定版本加--prefer-dist和--no-interaction参数安装，最后生成app_key并设好storage权限。
php -v 和 php -m 必须先跑通
装 Laravel 10 前不验证 PHP 版本和扩展，90% 的 composer create-project 会卡在「Resolving dependencies」或直接报错 Your requirements could not be resolved。这不是网络问题，是 PHP 层面硬性拦截。
- 运行
php -v，输出必须是PHP 8.1.x或更高 ——PHP 8.0.29都不行，Laravel 10 已彻底放弃对 8.0 的支持 - 运行
php -m | grep -E "(mbstring|openssl|pdo|tokenizer|xml|ctype|json|zip)"（Linux/macOS），缺任意一个就停手；Windows 用户打开php.ini，确认这些行没被注释：extension=mbstring、extension=openssl、extension=pdo_mysql、extension=zip - Mac 用户用 Homebrew 装的 PHP 8.2 常漏
intl，补上：brew install php@8.2（它会自动带全）；Ubuntu/Debian 缺intl就sudo apt install php-intl
Composer 版本和镜像源必须同步调好
composer --version 低于 2.5.0，拉 Laravel 10 就可能失败，尤其遇到 laravel/framework 的元数据解析异常，错误像 Could not find package laravel/laravel in a version matching "10.*" —— 这不是包不存在，是 Composer 旧版读不懂新格式。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 升级命令：
composer self-update（别加sudo，否则后续php artisan可能因权限写入失败而静默退出） - 国内用户必须换镜像源，否则
create-project卡在Installing dependencies是常态；全局生效命令：composer config -g repo.packagist composer https://packagist.phpcomposer.com - 如果已配过阿里云源，注意它已停用；别再用
https://mirrors.aliyun.com/composer/，现在只认https://packagist.phpcomposer.com或配代理走官方源
执行 create-project 时参数不能省
直接敲 composer create-project laravel/laravel myapp 很容易装错版本、卡在交互、或因内存不足解压失败。Laravel 10 不是“能跑就行”，是“参数对了才稳”。
- 锁定版本：用
^10.0显式指定，避免意外拉到 Laravel 11 预发布版：composer create-project laravel/laravel:^10.0 myapp - 加
--prefer-dist强制走压缩包安装，比 git clone 快且稳定，尤其在国内网络下 - 加
--no-interaction防止卡在是否启用 Jetstream/Breeze 的提问上，CI/CD 或脚本中必须加 - 如果提示
zlib_decode(): data error，说明缓存压缩包损坏，删掉~/.composer/cache再重试
装完立刻检查 .env 和 storage 权限
项目目录生成成功 ≠ 能访问 http://localhost:8000。很多人在 php artisan serve 报 Application key not set 或白屏后反复重装，其实只是漏了两步。
- 必须手动复制：
cp .env.example .env，Laravel 10+ 默认不自带.env - 必须立即生成密钥：
php artisan key:generate—— 手输、复制旧项目值、或留空都会导致 session 加密失效、CSRF 报错 - Linux/macOS 下，
storage和bootstrap/cache目录需写入权限：chmod -R 775 storage bootstrap/cache，否则日志写不进、缓存生成失败，php artisan命令会静默退出
APP_URL 设为 http://127.0.0.1:8000 —— 看似一样，但 Chrome 把 localhost 和 127.0.0.1 当作不同源，会导致邮箱链接跳转 404、前端跨域请求被拦。开发阶段老老实实填 http://localhost:8000。
