symfony 7.0 创建项目应使用 symfony new myapp --webapp 命令，预装 twig、webpack encore 等 web 工具链；运行 symfony server:start 并访问 https://127.0.0.1:8000 验证欢迎页即成功。

直接用 symfony new 命令就能快速生成一个开箱即用的 Symfony 项目，不用碰 composer.json、不手动配环境、不查包名——前提是已装好 Symfony CLI。

确保 Symfony CLI 已安装

没装的话，先装工具：

• macOS：运行 brew install symfony-cli/tap/symfony-cli
• Linux：运行 wget https://get.symfony.com/cli/installer -O - | bash
• Windows：下载并运行官方安装程序（如 Symfony CLI 5.17.1）

装完执行 symfony -v，看到版本号（比如 v5.12.0）就说明准备好了。如果提示 command not found，请重启终端，或把 ~/.symfony/bin 加进 PATH。

一条命令生成带 Web 能力的项目

运行：

symfony new myproject --webapp

其中 myproject 是你要创建的目录名，不能含空格或中文。这条命令会自动拉取 symfony/website-skeleton，预装 Doctrine、Twig、MakerBundle、WebProfiler 和 Flex，并生成完整的 public/index.php 和开发环境配置。

注意：不加 --webapp 就只是轻量骨架（symfony/skeleton），连 public 目录都没有，访问直接 404。

启动服务并验证

进项目目录：cd myproject

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

启动内置服务器：symfony server:start

它会自动启用 HTTPS、生成本地证书、打开浏览器访问 https://127.0.0.1:8000。首次运行可能弹窗提示信任证书，点允许即可。

验证是否跑通，运行：php bin/console about，重点看三行：

• Flex enabled: yes
• APP_ENV=dev
• APP_DEBUG=1

缺任何一个，后续做控制器、模板或命令都可能失败。

常见卡点与应对

如果 symfony new 卡在 “Installing dependencies”，大概率是网络慢，可临时切 Composer 镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com

如果 php bin/console 报错 “Could not open input file”，检查是否在项目根目录，或 Linux/macOS 下执行：chmod +x bin/console

Windows 用户若提示 “The system cannot find the path specified”，建议改用 Git Bash 或 CMD 运行，避开 PowerShell 执行策略限制。