新手安装 Symfony 应优先使用 Symfony CLI 创建完整项目，其次可选 Composer 骨架方式；需确保 PHP 8.1+、必要扩展及 Composer 已正确安装并配置 PATH。
安装 Symfony 对新手来说不难，关键在选对方式、避开常见坑。现在主流做法是用 Symfony CLI 或 Composer 创建项目，不再推荐旧版安装器（已停更）。Windows 和 macOS 步骤高度一致，差异仅在命令写法和路径处理上。
一、基础环境必须配齐
无论用哪种方式，以下三样缺一不可：
-
PHP 8.1+：检查命令
php --version；若未安装，去 windows.php.net（Win）或用brew install php（macOS）获取 -
启用必要扩展：编辑
php.ini，确保开启openssl、mbstring、xml、tokenizer；Windows 用户注意取消;extension=php_openssl.dll前的分号 -
Composer 已就位：运行
composer --version验证；如未装，Windows 下运行composer-setup.exe，macOS 执行：curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer
二、推荐新手：用 Symfony CLI 一键建完整项目
它自动集成 Twig、Doctrine、Webpack Encore、Security 等常用组件，省去手动配置麻烦，适合第一次跑起来看效果。
-
macOS：终端执行
brew install symfony-cli/tap/symfony-cli - Windows：下载官方 Symfony CLI 安装包，双击运行即可
- 验证安装：
symfony version应显示版本号 - 创建项目：
symfony new my_project --webapp（--webapp是当前新版替代--full的参数） - 启动服务：
cd my_project && symfony server:start，浏览器打开 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913 看到欢迎页即成功
三、备选方案：用 Composer 创建轻量骨架项目
适合想了解按需加载机制、或准备做 API/微服务的同学。结构极简，后续组件随用随装。
- 执行命令：
composer create-project symfony/skeleton my_project - 进入目录后，先装开发依赖：
composer require webapp（自动补全 Twig、Router、Form 等基础 Web 功能） - 启动内置服务器：
php -S 127.0.0.1:8000 -t public，或装了 Symfony CLI 就直接symfony server:start - 对比 CLI 方式，此法初始无控制器、无模板目录，需手动运行：
composer require maker-bundle --dev，再执行php bin/console make:controller Homepage才能生成页面
四、安装失败？先查这三处
90% 的卡点集中在这几个地方：
-
SSL 报错（cURL error 60）：Windows 用户检查
php.ini中openssl.cafile是否指向有效的cacert.pem；可去 curl.se/ca/cacert.pem 下载并配置 -
“command not found” 类提示：确认 PHP、Composer、Symfony CLI 的安装路径已加入系统
PATH；macOS 可用echo $PATH查看，Windows 在「系统属性 → 高级 → 环境变量」中检查 -
启动时报 “Class not found” 或空白页：进项目目录执行
composer install补全依赖；再清缓存：php bin/console cache:clear
