symfony跨平台安装关键在于统一php≥8.1、composer可用、intl等扩展启用及git安装；macos需配置shell path，windows原生安装最稳，wsl2须装php-intl，linux/docker需挂载composer缓存并换镜像源。
Symfony 跨平台安装的关键不是换系统重配，而是统一环境要求、识别各系统特有陷阱，并用现代方式（CLI 或 Composer）绕过老旧流程。现在主流用 PHP 8.1+、Composer 和 Symfony CLI，不再依赖已停更的 symfony installer 工具。
统一前置条件：三系统都得先过这关
无论哪个平台，必须满足以下四项，缺一不可：
-
PHP ≥ 8.1：运行
php -v确认；低于版本会报错或功能受限 -
Composer 已全局可用：执行
composer --version应返回版本号 -
必需扩展已启用：
intl、mbstring、fileinfo、curl；Linux/macOS 可用php -m | grep intl检查，Windows 需确认php.ini中对应 extension 行已取消注释 -
Git 已安装：Symfony 新项目会初始化 Git 仓库，且部分命令（如
make:*）依赖 Git 状态
macOS 安装要点：PATH 和 shell 初始化最容易翻车
用 Homebrew 安装 CLI 最稳：
- 执行
brew install symfony-cli/tap/symfony-cli - 检查当前 shell：
echo $SHELL—— macOS 默认是zsh，但老用户可能仍是bash - 若提示
command not found: symfony，说明 PATH 未生效：把export PATH="$HOME/.symfony/bin:$PATH"追加到~/.zshrc（zsh）或~/.bash_profile（bash），再运行source ~/.zshrc - 验证：
which symfony应输出路径，symfony version显示版本号
Windows 安装实操：WSL2 用户注意扩展缺失
推荐两种路径：
-
原生 Windows（非 WSL）：直接下载 Symfony CLI 安装程序，双击运行即可；确保 PHP 已加入系统环境变量（cmd 中能直接调用
php） -
WSL2（Ubuntu/Debian）：常因缺少
ext-intl报错Class 'IntlDateFormatter' not found；解决方法：sudo apt update && sudo apt install php-intl
若仍不生效，再执行sudo phpenmod intl - WSL2 时间不同步会导致
symfony server:start启动失败；临时修复：sudo hwclock -s
Linux / 容器环境避坑：缓存、权限与镜像源
在 Ubuntu/CentOS 或 Docker 容器中安装，要防三个隐形雷：
-
Composer 缓存失效：容器每次启动都是干净环境，需挂载缓存目录：
-v $HOME/.composer/cache:/root/.composer/cache -
国内网络超时：进容器后立刻切换镜像源：
composer config -g repo.packagist composer https://packagist.phpcomposer.com -
COMPOSER_HOME 不可写：Alpine 等最小镜像中
/root可能只读；启动容器时加参数：-e COMPOSER_HOME=/tmp/composer
创建项目：两条路，新手选 CLI，极简选 Skeleton
确认环境就绪后，任选其一：
-
推荐新手：用 Symfony CLI 创建完整栈
symfony new my_project --full
自动包含 Twig、Doctrine、Webpack Encore、Security 等，适合快速上手 Web 应用 -
适合学习或微服务：用 Composer 创建轻量骨架
composer create-project symfony/skeleton my_project
组件按需安装（composer require orm），无冗余，但需手动配路由、控制器等
项目建好后，进目录执行 symfony server:start（或 php -S 127.0.0.1:8000 -t public），打开 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a 看到欢迎页即成功。
