必须用 composer create-project 初始化 Symfony 项目，因其预置标准目录结构和配置；手动 require symfony/symfony 会缺失 bin/console、config/ 等关键文件，导致命令报错或 Kernel 找不到。
直接用 composer create-project，别手动生成 composer.json 再 require —— 那样装出来的不是标准 Symfony 项目结构，后续命令（比如 bin/console）会报错或不生效。
为什么不能用 composer require symfony/symfony 装框架？
这个包是旧版 Symfony 2/3 的“全量框架”聚合包，早已废弃；新版 Symfony 是组件化架构，symfony/symfony 不再维护，且安装后没有 bin/console、没有 config/ 目录结构，symfony/framework-bundle 也不会被自动启用。
常见错误现象：Command "make:controller" is not defined，或者 Kernel not found —— 因为没走官方项目骨架初始化流程。
- 正确路径：必须从官方项目骨架（skeleton）拉起，它预置了目录结构、基础配置和可执行脚本
- 使用场景：本地开发、CI 初始化、快速验证功能，而非向已有 Laravel 或纯 PHP 项目里“接入” Symfony
- 性能 / 兼容性影响：骨架已按最低 PHP 版本（如 Symfony 7 要求 PHP 8.1+）和推荐扩展（
ext-intl、ext-xml）做了约束，手动拼凑容易漏依赖
composer create-project 的参数怎么选？
核心就两个组合：是否带 Webpack Encore（前端资产编译），是否最小化（只含必要组件）。
推荐默认用官方完整骨架：composer create-project symfony/skeleton my-project —— 它轻量、无前端工具、启动快，适合 API 或后台服务。
- 要带 Webpack + Bootstrap/Vue/React 支持？改用：
composer create-project symfony/website-skeleton my-project - 想指定 Symfony 版本？加版本号：
composer create-project symfony/skeleton:^7.0 my-project（注意用^，不是v7.0） - 跳过脚本执行（比如 CI 环境禁止交互）？加
--no-interaction参数 - 如果卡在
Installing dependencies，大概率是网络问题，配好 Composer 国内镜像源（如阿里云）比换参数更有效
装完第一件事：确认 bin/console 能跑通
很多人以为 composer install 结束就完了，其实骨架生成后必须检查入口是否就位。这个文件是 Symfony 运行时的中枢，缺失或权限不对，所有命令都失效。
常见错误现象：Permission denied: ./bin/console（Linux/macOS）、Could not open input file: bin/console（Windows）。
- Linux/macOS 下运行：
chmod +x bin/console（否则会报 permission 错误） - Windows 用户若用 Git Bash，也需确保
bin/console有执行权限；若用 CMD/PowerShell，则应改用php bin/console显式调用 - 运行
php bin/console list，看到命令列表才算真正就绪；如果报Class "Symfony\Component\HttpKernel\Kernel" not found，说明vendor/autoload.php没加载，检查bin/console头部的 require 路径是否被意外修改
最常被忽略的是 bin/console 文件权限和 APP_ENV 环境变量设置——很多调试问题其实不是框架装错了，而是命令根本没进 Kernel 生命周期。装完别急着写 Controller，先让它吐出一串命令列表。
