唯一正解是用composer create-project拉取官方骨架，因其提供完整目录结构和预设配置；手动require或全局安装会导致缺失src/、bin/console等关键文件，引发kernel未找到等错误。

直接用 composer create-project 创建项目，不是“安装框架”，而是拉取一个预配置好的完整骨架；手动 composer require symfony/framework-bundle 或全局装 symfony/symfony 会导致结构缺失、Class not found: App\Kernel 等问题，已不适用。

为什么不能用 composer require 安装 Symfony 框架

因为 symfony/framework-bundle 只是组件，不是可运行项目：它不带 src/、public/index.php、bin/console、.env 或自动加载规则。你得到的是一个“空壳依赖”，不是应用。

• composer require symfony/framework-bundle 后执行 php public/index.php 必报 Warning: require(vendor/autoload.php): failed to open stream —— 因为 public/ 根本不存在
• composer global require symfony/symfony 已废弃（Packagist 标为 abandoned），装完只有空目录，无任何启动入口
• 即使硬凑出 Kernel 和 index.php，也会缺 Flex recipes，导致 cache:clear 报错 Unable to write in the cache directory 或路由不生效

create-project 的骨架选型与版本锁定

不同骨架决定项目起点和后续扩展成本：symfony/skeleton 是最小 API 启动模板，symfony/website-skeleton 预装 Twig、WebProfiler、AssetMapper 和基础构建支持。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 纯 API / 微服务：用 composer create-project symfony/skeleton:^6.4 myapi（PHP ≥ 8.1）
• 传统 Web 应用：用 composer create-project symfony/website-skeleton:^6.4 myweb
• 目标目录（如 myapi）必须不存在，否则命令直接失败 —— 它不覆盖，也不提示
• 加 --no-interaction --prefer-dist 可跳过交互、强制用压缩包，适合 CI 或网络不稳定环境

安装后必须立即执行的三步初始化

很多人跑完 create-project 就开浏览器，结果 500 或白屏 —— 缺少这三步，项目只是“半成品”。

• 进目录手动跑一次 composer install：虽然 create-project 默认会触发，但网络中断或缓存异常时可能静默失败；这步确保 Flex recipe 正确注入 config/packages/ 并完成 assets:install
• 检查 .env 中 APP_ENV=dev 是否生效（别留着 prod 还没清缓存）
• 首次运行前必须 php bin/console cache:clear：否则 var/cache 目录权限不对（尤其 WSL/Docker 下必报 Unable to write in the cache directory）

底层组件按需安装与稳定性控制

如果你只是想在非 Symfony 项目里用某个功能（比如命令行或 HTTP 抽象），才用 composer require 装单个组件；此时无需骨架，但要注意版本与 PHP 匹配。

• 装组件示例：composer require symfony/console:^6.4、composer require symfony/http-foundation:^6.4
• UX 类组件（如 symfony/ux-turbo）默认无稳定版，得显式指定分支：composer require symfony/ux-turbo:dev-main
• 绝不能把 composer.json 里的 "type" 改成 "library" —— 这会让 bin/console 找不到 App\Kernel，因 Symfony 自动加载依赖 "project" 类型
• PHP 版本不匹配时，Composer 不会明确报错，而是卡在 Your requirements could not be resolved —— 先确认 php -v 是否 ≥ 8.1（6.x）或 ≥ 8.2（7.x）

最容易被忽略的是：create-project 只复制骨架，vendor/ 依赖是否真装上，得靠 composer install 实锤；而 cache:clear 不仅清缓存，更是修复 var/cache 权限的关键动作，尤其跨平台开发时，这一步漏了就等于没装完。