核心三步：环境配对（PHP≥8.2+五大扩展）、项目建对（symfony new myapp --webapp）、命令用对（make:controller生成控制器并渲染动态模板），10分钟内跑通MVC。
装好 Symfony 并跑出第一个控制器，核心就三件事：环境配对、项目建对、命令用对。不用改配置文件，不碰 php.ini，10 分钟内能完成。
确认 PHP 和扩展已就绪
打开终端，依次执行：
- php -v —— 必须显示 ≥ 8.2（2026 年主流要求），不是网页 phpinfo，是命令行输出
- php -m | grep -E "(intl|mbstring|xml|curl|fileinfo)" —— 五个扩展缺一不可，尤其 intl，常被忽略
-
composer -v —— 确保 Composer 已安装；国内用户建议提前设镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 若提示插件被禁（如 “plugins are disabled”），立刻运行：
composer config -g allow-plugins true
创建项目（新手推荐 CLI 方式）
比 composer create-project 更省心，自动带完整栈：
- macOS：运行
brew install symfony-cli/tap/symfony-cli - Linux：运行
wget https://get.symfony.com/cli/installer -O - | bash - Windows：去 symfony.com/download 下载安装程序
- 验证：运行
symfony -v，有版本号即成功 - 建项目：
symfony new myapp --webapp（注意：--full 已弃用，新版统一用 --webapp）
启动服务并生成第一个控制器
进项目目录后，两步到位：
立即学习“PHP免费学习笔记（深入）”；
- 启动服务：
cd myapp && symfony server:start，浏览器访问 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913，看到绿色欢迎页即成功 - 生成控制器：
php bin/console make:controller HomepageController（自动创建类、路由和模板目录） - 编辑
src/Controller/HomepageController.php，把index()方法改成：
- 在
templates/homepage/index.html.twig中写：<h1>你好，{{ name }}！</h1> - 访问 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913 或 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913/homepage，看到动态标题，MVC 就通了
常见卡点与快速修复
遇到报错别慌，优先查这三项：
-
“Command not found: make:controller” → 运行
composer require --dev symfony/maker-bundle -
500 错误或白屏 → 先清缓存：
php bin/console cache:clear，再检查var/cache和var/log是否可写 -
页面不更新 / 路由 404 → 运行
php bin/console debug:router看是否注册成功；确认.env中APP_ENV=dev和APP_DEBUG=1已启用
