需依次安装xcode命令行工具、homebrew、cmake、python 3.11、android sdk/ndk（可选）及cocos2d-x；xcode工具必须最先安装，否则brew卡在“checking for clang”；python必须用3.11版，因4.x不兼容3.12+；ndk须用r21e或r25b，r26+报std::filesystem错误。
在Mac终端中搭建Cocos2d-x开发环境，需依次安装Xcode命令行工具、Homebrew、CMake、Python 3、Android SDK/NDK（如需安卓构建）及Cocos2d-x本身，缺一不可，否则后续创建项目或编译会直接报错。
安装Xcode命令行工具
打开终端，执行：
sudo xcode-select --install
系统弹出窗口后点击“安装”，等待完成。这一步必须先做，否则Homebrew无法安装——【Xcode命令行工具未安装时，brew install会卡在“checking for clang”并无限等待】。
安装Homebrew与基础依赖
在终端中粘贴并运行官方一键安装命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后，立即执行：
brew update && brew install cmake python@3.11
注意：必须指定python@3.11而非最新版，因Cocos2d-x 4.x目前不兼容Python 3.12+的某些API变更，用3.12会导致setup.py执行失败。
配置Android开发支持（可选但常见）
方法一：用Homebrew安装（推荐，版本可控）
brew install android-platform-tools android-sdk android-ndk
方法二：手动下载SDK/NDK（仅当需要特定旧版本时）
从developer.android.com下载commandlinetools-mac-*.zip → 解压到~/Library/Android/sdk/cmdline-tools/latest/ → 运行sdkmanager --list确认可用
【NDK版本必须为r21e或r25b，r26+会导致ndk-build报错undefined reference to 'std::filesystem'】
下载并配置Cocos2d-x
第一步：进入你想存放引擎的目录，例如：
cd ~/Documents
第二步：克隆稳定分支（以v4.0.2为例）：
git clone --branch v4.0.2 https://github.com/cocos-creator/cocos2d-x.git
第三步：进入引擎目录并运行配置脚本：
cd cocos2d-x → python3 setup.py
第四步：按提示连续敲三次回车，接受默认路径（即$HOME/bin/cocos, $HOME/bin/android-sdk, $HOME/bin/android-ndk）→ 脚本自动写入~/.zshrc环境变量
第五步：重载配置：
source ~/.zshrc
