应选用symfony 6.4 lts——2023年11月发布，安全支持至2027年11月，php 8.1+兼容，生态成熟稳定；7.4虽为新lts但截至2026年6月适配尚不完善，8.0未发布。
直接用 composer create-project 安装 Symfony 6.4 LTS，这是当前（2026年中）最稳、最适配企业级项目的版本——安全支持到2027年11月，PHP 8.1+ 兼容，生态成熟，文档齐全，Bundle 支持充分。
为什么选 6.4 而不是更新的版本？
Symfony 7.4 虽已在 2025年11月发布，也属 LTS，但截至 2026年6月，其官方 Bundle（如 Doctrine、API Platform）、主流教程和 CI/CD 模板仍在适配中；而 6.4 经过两年多生产环境验证，组件行为稳定、错误提示清晰、社区答疑响应快。Symfony 8.0 尚未发布，不可用。
安装命令与模板选择
根据项目类型选对应骨架：
-
传统 Web 应用（含 Twig、WebProfiler、AssetMapper、基础前端构建）：
composer create-project symfony/website-skeleton:"6.4.*" my_project -
API / 微服务 / 命令行工具（最小依赖，无模板引擎）：
composer create-project symfony/skeleton:"6.4.*" my_project
注意：目标目录 my_project 必须不存在，否则命令失败；加 --no-interaction --prefer-dist 可跳过交互并提速。
安装后必做的三件事
-
确认依赖已真正安装：create-project 末尾会自动执行
composer install，但网络异常时可能静默失败。进入项目后手动运行composer install，再检查vendor/autoload.php是否可读。 -
清空缓存并设对环境：首次运行前必须执行
php bin/console cache:clear，尤其在 WSL 或 Docker 下，否则常报“Unable to write in the cache directory”；同时确认.env中APP_ENV=dev已生效（生产环境请改用prod）。 -
启动开发服务器：推荐使用内置命令
php -S localhost:8000 -t public，或装 Symfony CLI 后运行symfony server:start。访问http://localhost:8000前，请确保public/index.php存在且未被误删。
避坑提醒：常见失败原因
- PHP 版本不匹配：6.4 要求 PHP ≥ 8.1，6.4.10 起推荐 PHP 8.3；若服务器仍跑 PHP 7.4，必须先升级 PHP。
- 误用废弃命令：
symfony new和composer global require symfony/symfony已失效，会导致缺失bin/console、public/index.php等关键文件。 - 忽略 Bundle 兼容性：若项目依赖
EasyAdminBundle或API Platform，请查其官方文档确认是否已正式支持 6.4（截至 2026年5月，主流 Bundle 均已完成适配）。
