正确起步Symfony项目必须用composer create-project生成完整骨架，而非全局安装或手动require；需进入项目目录执行composer install，并确保PHP版本匹配（如Symfony 6+要求PHP≥8.1）。
composer create-project 装 Symfony 项目，别用 global require
直接全局装 symfony/symfony 或 symfony/cli 不等于有了可运行的项目——那只是工具或框架源码，不是你该部署的“应用”。真正起步得用 create-project 命令生成带完整目录结构、composer.json 和基础配置的独立项目。
常见错误是跑 composer require symfony/framework-bundle 在空目录里硬凑，结果缺 public/index.php、没 config/、路由不生效，最后卡在 “The page isn’t working” 里反复刷新。
- 正确姿势：
composer create-project symfony/skeleton my_project（最小骨架）或composer create-project symfony/website-skeleton my_project（带 Twig、Doctrine 等常用组件） -
skeleton默认不含 Web Server Bundle，要本地访问得额外composer require web-server-bundle --dev - 生成后立刻进目录跑
php -S 127.0.0.1:8000 -t public，比等 Symfony CLI 安装更直觉、少权限问题
symfony cli 工具装不装？看场景再决定
symfony-cli 提供 symfony serve、symfony console 等便捷命令，但它不是必须项。很多教程默认推它，却没说清：它本质是第三方封装，和 Composer 无绑定关系，且在某些 Linux 发行版或 CI 环境里会因权限或 PATH 问题掉链子。
如果你只是本地开发小项目、不碰 API Platform 或 Maker Bundle，用原生 PHP 内置服务器 + bin/console 完全够用；但若频繁建 Controller、Entity，symfony cli 配合 make:controller 这类命令确实省几秒敲键盘时间。
- 装它前先确认：
curl -sS https://get.symfony.com/cli/installer | bash后记得source ~/.symfony/bin或重启 shell，否则symfony命令找不到 - CI/CD 流水线里建议绕过
symfony cli，直接用php bin/console cache:clear --env=prod --no-debug，避免引入额外依赖层 - Mac M1/M2 用户注意：
symfony cli旧版本对 arm64 支持不稳定，优先用brew install symfony-cli装 Homebrew 版本
vendor/autoload.php 找不到？检查 composer install 是否真执行了
新建项目后跑 php public/index.php 报错 Warning: require(vendor/autoload.php): failed to open stream，不是 Symfony 的锅，是 Composer 根本没拉依赖。很多人以为 create-project 自动做完所有事，其实它只复制代码骨架，vendor/ 是空的，必须手动补上依赖安装步骤。
这个错误高发于跳过 cd my_project 直接在父目录操作，或误把 composer install 当成可选步骤。
- 务必进入项目根目录（即含
composer.json的那层），再执行composer install - 如果网络慢导致超时，加
--prefer-dist或换国内镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com - Windows 用户注意：PowerShell 默认禁用脚本执行，
composer install可能静默失败，换 CMD 或 Git Bash 更稳
Symfony 6+ 默认用 PHP 8.1，别硬塞到 PHP 7.4 环境里跑
官网下载页不标 PHP 版本兼容性，但 symfony/skeleton 的 composer.json 里明确写了 "php": ">=8.1"。强行在 PHP 7.4 下 composer create-project 会报一堆 require does not match your PHP version，甚至成功生成但运行时报 ParseError: syntax error, unexpected token——那是 PHP 8.0+ 的联合类型、构造器属性提升语法在作祟。
这不是配置问题，是语言层不兼容。别折腾 platform 配置骗过 Composer，底层扩展和核心类已依赖新特性。
- 查当前 PHP 版本：
php -v；查 Composer 允许的 PHP 版本：composer show symfony/symfony | grep requires - PHP 7.4 用户请降级使用
symfony/skeleton:^5.4，但注意 Symfony 5.4 是最后一个支持 PHP 7.4 的长期支持版，2025 年后不再维护 - Docker 用户可在
docker-compose.yml里指定image: php:8.2-apache，比本地升级 PHP 更快见效
框架版本和 PHP 版本的咬合点，永远比文档里写的更紧。一个 composer.json 里的 php 字段，就是实际运行边界的铁丝网。
