直接用 composer require 安装 Symfony 组件即可，无需框架或 CLI 工具；组件独立发布，自动处理依赖与版本约束，注意 PHP 版本匹配、UX 组件需指定 dev-main、避免手动改 composer.json 或误设 stability/type。
直接用 composer require 就行，不需要框架、不用骨架、不碰 CLI 工具。 Symfony 组件是独立发布的包，symfony/console、symfony/http-foundation 这类组件和你的项目类型无关，只要 Composer 能跑，就能装。
装单个组件：用 composer require，别手动改 composer.json
你不是在“安装 Symfony”，而是在引入某个功能模块。比如加命令行支持：
composer require symfony/console
- 这条命令会自动写入
composer.json的require区、下载包、更新vendor/和composer.lock - 不要先手动往
composer.json里加一行再composer update——多一步就多一个出错点 - 如果报
Root package 'xxx' cannot be installed as it is not a valid PHP package，说明当前目录没有composer.json，先运行composer init - 组件之间有依赖，但 Composer 会自动拉取最小必要集，比如
symfony/routing会带symfony/http-foundation，但不会拖进来symfony/framework-bundle
版本怎么选：用 ^ 约束主版本，别用 * 或裸数字
Symfony 组件严格遵循语义化版本（SemVer），^6.4 表示允许升级到 6.x 所有小版本（如 6.4.10、6.5.2），但绝不会升到 7.0。
- 推荐显式写
"symfony/http-kernel": "^6.4"，而不是"^6.0"—— 后者在6.4发布后仍可能锁死在6.0.x，错过关键修复 - 绝对避免用
*，它会让 Composer 自由选最新版，极易引发兼容性断裂 - PHP 版本要匹配：Symfony 6.x 要求 PHP 8.0+，7.x 要求 PHP 8.2+；用低版本 PHP 装高版本组件会静默失败或报奇怪的解析错误
装 UX 类组件（如 symfony/ux-turbo）：必须指定 dev-main 或调低稳定性
很多 UX 组件尚未发布稳定版，Packagist 上只有 dev-main 分支。默认 "minimum-stability": "stable" 会直接忽略它们。
- 最安全做法：显式指定开发版，例如
composer require symfony/ux-turbo:dev-main - 若需批量安装多个 UX 包，可临时改
composer.json中的"minimum-stability"为"dev"，但上线前务必改回"stable" - 切勿把
"type"改成"library"—— 这会导致bin/console启动时报Class 'App\Kernel' not found，因为 Symfony 的自动加载逻辑依赖"project"类型
缓存与镜像问题：报 Could not find package 别急着重装 Composer
symfony/skeleton 或 symfony/console 在 Packagist 上始终可用。报找不到，90% 是本地环境干扰。
- 先清缓存：
composer clear-cache - 检查是否用了国内镜像源并拦截了某些包，临时切回官方源：
composer config -g repo.packagist composer https://packagist.org - 确认没误加
--stability=stable这类参数——组件默认就是 stable，加了反而可能过滤掉兼容版本 - Windows 下若
php bin/console报Class 'App\Kernel' not found，大概率是项目类型被改过或 autoloader 没刷新，试下composer dump-autoload
真正容易被忽略的是组件的“隐式依赖”：比如 symfony/cache 默认只提供抽象层，要启用 APCu 缓存得额外 composer require symfony/cache-contracts symfony/cache 再配适配器；文档里写的“requires”不是可选建议，是运行前提。
