laravel 11本地部署需严格满足php≥8.2、启用mbstring/openssl/pdo/tokenizer/xml/ctype/json/bcmath/fileinfo/zip/curl扩展，macos用brew install php@8.4并配置path，windows推荐php.new一键脚本；必须用composer 3.x并切阿里云镜像；项目创建须用laravel new --no-interaction或composer create-project --no-interaction，进目录后立即php artisan key:generate；.env需手动复制并配置数据库与时区。

直接上手，不绕弯。Laravel 在 Windows 和 macOS 上都能跑得稳，关键不是选哪个系统，而是把几个核心环节配对、配齐、配准——PHP 版本、扩展、Composer、项目初始化方式、文档工具链。下面按实际操作分块说明，每步都标清平台差异和避坑点。

确认并安装满足要求的 PHP 环境

Laravel 11 要求 PHP ≥ 8.2，且必须启用以下扩展：mbstring、openssl、pdo、tokenizer、xml、ctype、json、bcmath、fileinfo、zip、curl。缺一不可，否则 artisan 命令或迁移会直接报错。

• macOS：推荐用 Homebrew 安装，命令简洁可靠：
  brew install php@8.4
  安装后执行 brew link php@8.4 并把 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）加入 PATH。验证用 php -v && php -m | grep -E "(mbstring|pdo|openssl)"
• Windows：不建议手动解压 ZIP 包配环境变量。优先使用官方推荐的 php.new/install/windows/8.4 一键脚本（以管理员身份运行 PowerShell），它自动处理 PATH、INI 配置和常用扩展启用。安装后重启终端，运行 php --ini 确认加载的是你预期的 php.ini 文件

安装 Composer 并设为国内源

Composer 是 Laravel 的“命脉”，必须全局可用，且源要切到国内镜像，否则 create-project 极易卡在 vendor 下载环节。

macOS Automator Services

部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

下载

• macOS 执行：
  curl -sS https://getcomposer.org/installer | php
  sudo mv composer.phar /usr/local/bin/composer
  composer config -g repo.packagist composer https://mirrors.aliyun.com/composer
• Windows 执行（PowerShell 管理员模式）：
  [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
  iex ((New-Object System.Net.WebClient).DownloadString('https://getcomposer.org/installer'))
  Move-Item composer.phar "C:\ProgramData\ComposerSetup\bin\composer.phar"
  composer config -g repo.packagist composer https://mirrors.aliyun.com/composer

创建 Laravel 项目：两种方式任选其一

推荐用 laravel new（需先装 Laravel Installer），比 create-project 更快、更干净，自动预装测试框架与 starter kit。

• 先全局安装安装器：
  composer global require laravel/installer
  注意：确保 ~/.composer/vendor/bin（macOS/Linux）或 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows）已加入 PATH
• 新建项目（支持交互式选择）：
  laravel new myapp
  进入后立即执行：
  php artisan key:generate
  若提示 .env 不存在，复制 .env.example 并重命名为 .env 再执行

本地文档工具链配置（含中文支持）

Laravel 官方文档是英文的，但开发中常需快速查 API 或看中文解释。可组合使用以下两个轻量级方案：

• 本地离线文档（推荐）：访问 https://laravel.com/docs/11.x → 页面右下角点击 Download PDF，或用开源工具 laravel-docs-offline 生成 HTML 离线站（支持搜索、跳转、中英双语索引）
• IDE 内联提示增强：在 VS Code 中安装插件 Laravel Blade Snippets + PHP Intelephense；在 PhpStorm 中启用 Laravel Plugin 并勾选 “Enable Laravel Idea” —— 这能解析 config/、routes/ 和 Eloquent 关系，补全准确率大幅提升