用 symfony cli 创建 symfony 6.4 稳定版项目需执行 symfony new myapp --webapp，确保 php ≥ 8.1、intl 扩展启用，并通过 php bin/console about/list/make:controller 三步验证环境就绪。
用 Symfony CLI 创建 Symfony 6 稳定版项目，最关键是选对命令、避开预发版陷阱、验证三要素是否就绪。2026 年当前（Symfony 6.4 是最新稳定 LTS 版），--full 参数已彻底废弃，--webapp 是唯一有效且推荐的选项。
安装并验证 Symfony CLI
CLI 是启动项目的前提，它自动处理版本锁定、依赖注入和环境初始化：
- macOS：运行
brew install symfony-cli/tap/symfony-cli - Linux：运行
wget https://get.symfony.com/cli/installer -O - | bash - Windows：去 symfony.com/download 下载安装包并运行
- 安装后执行
symfony -v，看到类似v5.17.1的输出即成功 - 若提示 command not found，请将
~/.symfony/bin加入系统 PATH，并重启终端
创建 Symfony 6.4 稳定版项目
执行以下命令，明确指定 Web 应用类型，避免拉到 7.x 预发版：
-
symfony new myapp --webapp（推荐，全自动且稳定） - 项目名
myapp必须为英文、无空格、无特殊字符 - 该命令会自动拉取
symfony/website-skeleton的 6.4.* 分支，内置 Doctrine、Twig、MakerBundle、WebProfilerBundle 和 Flex - 生成后立即拥有
public/index.php、src/Controller/DefaultController.php和根路由/ - 不加
--webapp会退化为轻量骨架（类似symfony/skeleton），无 public 目录、无 Twig、无法直接访问
启动并验证开发环境
进入项目目录后，三步确认一切就绪：
- 执行
cd myapp切换到项目根目录 - 运行
symfony server:start启动服务（默认地址https://127.0.0.1:8000） - 浏览器打开欢迎页后，立刻运行以下三条命令交叉验证：
-
php bin/console about→ 检查是否同时显示 Flex enabled: yes、APP_ENV=dev、APP_DEBUG=1 -
php bin/console list→ 查看是否列出make:controller、make:entity等超过 120 条命令 -
php bin/console make:controller Test→ 成功生成控制器即说明 MakerBundle 已激活、Twig 可渲染、路由可注册
常见问题与修复要点
即使用了 --webapp，仍可能卡在启动环节，核心只看三点：
-
php -v输出必须 ≥ 8.1（Symfony 6.4 强制要求） -
php -m | grep intl必须有输出（intl 扩展缺失会导致 Doctrine 迁移失败、Twig 本地化报错） - 若
symfony server:start提示证书错误，删除~/.symfony/certs/目录后重试，CLI 会自动生成新证书 - 不要用
php bin/console server:run—— 它已被弃用，不支持 HTTPS、无环境变量热加载、PHP 8.1+ 下易端口冲突 - Windows 用户若遇路径错误，优先改用 Git Bash 或 CMD，避开 PowerShell 执行策略限制
