最可靠方式是用 composer create-project symfony/skeleton 创建项目，它自动处理依赖、autoload、入口绑定等；手动建 composer.json 易漏 Symfony 特有逻辑，导致 console 报错或路由失效。
直接用 create-project 命令，别手动生成 autoload 或手动 require
Composer 创建 Symfony 项目最可靠的方式就是调用 create-project，它会自动下载对应版本的 Symfony 框架骨架（skeleton），并完成依赖安装、autoload 注册、权限检查等。手动生成 composer.json 后再 composer install 容易漏掉 Symfony 特有的引导逻辑（比如 public/index.php 的入口绑定、config/bundles.php 的自动注册机制），导致后续 bin/console 报错或路由不生效。
推荐命令：
composer create-project symfony/skeleton my-project
如果需要特定版本（如 7.1）：
composer create-project symfony/skeleton:^7.1 my-project
- 不加
^可能因版本约束太松而装到非 LTS 版本，线上环境慎用 - 项目名
my-project不能含大写字母或特殊符号，否则部分 Symfony 组件（如 MakerBundle）生成类时会出问题 - 执行后会自动运行
composer install，无需再手动执行
安装 Webpack Encore 或其他官方包时，注意 dev vs prod 环境标记
Symfony 官方推荐的前端构建工具是 Webpack Encore，但它默认只在 dev 环境下启用。如果你执行 composer require symfony/webpack-encore-bundle 后发现 assets:install 报错或 CSS 不加载，大概率是因为你没区分环境——该包的配置文件 config/packages/webpack_encore.yaml 默认带 when@dev 条件。
常见操作误区：
- 在生产环境运行
npm run build却忘了先执行APP_ENV=prod composer install --no-dev，导致node_modules被删，build失败 - 把
symfony/webpack-encore-bundle放进require-dev，结果正式部署时 bundle 找不到，Encore类无法加载 -
assets:install命令在APP_ENV=prod下默认跳过软链接（因安全限制），需显式加--symlink参数才能让public/build/正确指向public/build/
vendor/bin/simple-phpunit 和 bin/phpunit 的区别必须分清
新 Symfony 项目里会出现两个 PHPUnit 可执行文件：vendor/bin/simple-phpunit 和 bin/phpunit。前者是 Symfony 提供的封装脚本，会自动下载匹配当前 Symfony 版本的 PHPUnit PHAR；后者是你自己配置的、可能指向全局或旧版本 PHPUnit 的二进制。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
直接运行 bin/phpunit 很容易报错：
-
Class 'PHPUnit\Framework\TestCase' not found：因为bin/phpunit没走 Composer autoloader，也未加载 Symfony 的测试引导逻辑 -
PHP Fatal error: Uncaught Error: Class "Symfony\Bundle\FrameworkBundle\Test\KernelTestCase"：说明测试用例继承了 Symfony 测试基类，但bin/phpunit没载入autoload-dev或未初始化 Kernel
正确做法是统一用：
./vendor/bin/simple-phpunit
它会自动处理 PHPUnit 版本对齐、phpunit.xml.dist 加载、以及 SYMFONY_PHPUNIT_VERSION 环境变量控制。
升级 Symfony 主版本前，先跑 composer update --dry-run
很多人在 composer.json 里把 "symfony/*": "^6.4" 改成 "^7.0" 后直接 composer update，结果 CI 突然失败，本地也一堆 Class not found 或 Deprecated: Method xxx is deprecated。这是因为 Symfony 7 移除了大量旧组件（如 symfony/templating）、重命名了服务 ID（如 doctrine.dbal.default_connection → doctrine.dbal.default_connection 不再存在），还强制要求 PHP 8.2+。
建议流程：
- 先改
composer.json中的版本约束 - 运行
composer update --dry-run --with-dependencies，看哪些包会被升级/降级/移除 - 重点检查
symfony/framework-bundle、symfony/http-kernel、symfony/console是否同步升级，避免混用 v6 和 v7 组件 - 查看
UPGRADE-7.0.md中的 breaking changes，尤其是 Doctrine、Messenger、Cache 组件的变更点
实际升级不是改个数字就完事，框架内核和服务容器的行为变化会穿透到业务代码里，比如 Request::getContentType() 在 7.0 中已废弃，得换成 getContentTypeFormat() —— 这类细节不会被 --dry-run 提示，只能靠文档和测试覆盖兜底。
