关键是通过统一PHP版本与扩展、Symfony CLI工具链及容器化（Docker）屏蔽系统差异，配合.env.local和.gitattributes规范配置与换行，实现Windows/macOS多站点虚拟主机一致运行。
装 Symfony 本身不难，难点在于让它的底层依赖在 Windows 和 macOS 上都跑得稳、配得一致，尤其要支持多站点虚拟主机这种常见开发场景。关键不是分别折腾两个系统，而是用统一逻辑应对差异——PHP 版本与扩展必须对齐，CLI 工具链统一用 Symfony CLI，Web 服务层则根据宿主系统选合适托管方式（内置 server / Apache / Nginx），虚拟主机配置需绕过系统级权限和路径陷阱。
统一前置：三系统共通的硬性门槛
不管用哪套 Web 托管方案，以下四点必须先验证通过：
-
PHP ≥ 8.1：运行
php -v确认版本；低于则重装（Windows 去 windows.php.net 下 NTS 包，macOS 用brew install php） -
必需扩展已启用：
intl、mbstring、curl、openssl、xml、zlib；Windows 检查php.ini中对应extension=行是否取消注释，macOS 可用php -m | grep intl快速筛查 -
Composer 全局可用：执行
composer --version有输出；国内用户建议立即配置镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
Symfony CLI 已安装并生效：macOS 执行
brew install symfony-cli/tap/symfony-cli，Windows 下载官方symfony-cli-windows-amd64.exe放入 PATH 目录；验证用symfony version
多站点虚拟主机：两种通用落地方式
想在同一台机器跑多个 Symfony 项目（如 site-a.test、site-b.test），不推荐直接改 hosts + 启动多个 symfony server:start（端口易冲突、TLS 证书难管理）。更稳妥的是分场景选型：
Windows 日历同步
下载
将提醒同步至 Windows/Outlook 日历。用户提及「提醒我」「设置提醒」「加到日历」「同步到日历」「日程」「calendar」「日历」时触发。支持Microsoft Graph API 设备代码流认证，无需 Web 服务器，直接写入用户 Outlook 日历。
-
开发阶段首选 Symfony CLI 内置反向代理模式：运行
symfony proxy:start启动本地代理，再为每个项目单独执行symfony server:start --no-tls --port=8001（依次换端口），最后在浏览器访问https://site-a.wip或https://site-b.wip——无需改 hosts，自动解析，跨平台行为一致 -
需要真实域名或对接 Apache/Nginx 时，走标准虚拟主机配置：Windows 用 XAMPP/WAMP，macOS 用 Homebrew Apache 或原生 Nginx；核心是把每个项目的
public/目录设为 DocumentRoot，并启用mod_rewrite（Apache）或try_files（Nginx）；域名统一加进C:\Windows\System32\drivers\etc\hosts（Win）或/etc/hosts（macOS），格式均为127.0.0.1 site-a.test
Windows 与 macOS 配置差异避坑要点
同一套虚拟主机配置，在两边容易因细微差异失效。重点关注以下几处：
-
路径分隔符与大小写：Apache/Nginx 配置中一律用正斜杠
/；避免硬编码C:\project\public或/Users/name/project/public，改用%kernel.project_dir%/public或环境变量${PROJECT_DIR}/public -
PHP 扩展加载路径：Windows 的
extension_dir在php.ini中通常写相对路径"ext"即可；macOS Homebrew 安装的 PHP，扩展路径默认为/opt/homebrew/lib/php/pecl（Apple Silicon）或/usr/local/lib/php/pecl（Intel），需确认intl对应的.so文件真实存在 -
SSL/TLS 证书问题：Windows 上 OpenSSL 配置常出错，启动内置 server 时加
--no-tls更可靠；macOS 若提示证书不受信任，可在 Safari 中手动信任localhost证书，或改用symfony server:ca:install重新签发 -
端口占用排查逻辑不同：macOS 用
lsof -i :8000查进程，Windows 用netstat -ano | findstr :8000，杀进程命令也不同（macOSkill -9 PID，Windowstaskkill /PID PID /F）
项目级可移植配置建议
让一个 Symfony 项目在 Windows 和 macOS 上都能“开箱即用”，靠的是声明式而非手动配置：
- 所有 Web 服务器配置（Apache vhost / Nginx server block）存入项目
config/目录，附带 README 说明启用步骤 - 用
.env.local覆盖环境变量，避免写死数据库路径、缓存目录等；敏感值不提交 Git - 在
docker-compose.yml中定义完整栈（nginx + php-fpm + db），开发时统一docker-compose up启动，彻底屏蔽宿主系统差异 - Git 提交
composer.lock，并在.gitattributes中强制 LF 换行：* text=auto eol=lf，防止 lock 文件校验失败
