推荐使用 Homebrew 安装：先安装 Homebrew，再执行 brew install --cask chromium，系统自动适配 M1/M2 芯片的 Arm64 版本，安装后需在隐私与安全性中点击“仍要打开”以解除隔离限制。
如果您希望在 macOS 系统上安装 Chromium 浏览器——一款开源、轻量且高度可定制的浏览器，但遇到官网下载版本不兼容 M1/M2 芯片、Homebrew 安装失败或手动安装后无法启动等问题，则可能是由于架构不匹配、代理缺失或系统安全限制所致。以下是多种可靠、经验证的安装方法：
一、通过 Homebrew 安装（推荐 Intel 与 Apple Silicon 通用方案）
Homebrew 是 macOS 上最稳定的包管理工具，配合官方维护的 cask 可自动适配芯片架构，并处理依赖与权限问题。
1、打开终端，执行命令安装 Homebrew（如尚未安装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、安装完成后，运行以下命令更新本地仓库：
brew update
3、执行安装指令，该命令将自动识别 Apple Silicon 并拉取 Arm64 构建版本：
brew install --cask chromium
4、安装完毕后，在“启动台”或“应用程序”文件夹中查找 Chromium 图标并启动；首次运行时若提示“已损坏”，需前往系统设置 → 隐私与安全性 → 点击‘仍要打开’。
二、从官方快照源手动下载 Arm64 版本（专为 M1/M2/M3 芯片设计）
Chromium 官方快照站点提供按平台与架构细分的每日构建版本，直接下载 Mac_Arm 类型可确保原生运行，避免 Rosetta 转译导致的崩溃或性能下降。
1、在 Safari 或其他浏览器中访问：
https://download-chromium.appspot.com/dl/Mac_Arm?type=snapshots
2、页面将自动跳转至最新 Arm64 构建的 ZIP 压缩包下载链接（URL 形如 https://storage.googleapis.com/chromium-browser-snapshots/Mac_Arm/.../chrome-mac.zip）
3、下载完成后，双击解压 ZIP 文件，进入解压后的 chrome-mac 文件夹
4、将其中的 Chromium.app 拖入“应用程序”文件夹
5、首次启动前，需在终端执行一次授权命令以绕过 Gatekeeper 限制：
xattr -d com.apple.quarantine /Applications/Chromium.app
三、使用国内镜像源加速下载（解决网络超时与 502 错误）
当通过 Puppeteer 或脚本方式触发 Chromium 下载失败（如报错 502 Bad Gateway），本质是请求被重定向至境外服务器且未携带有效代理。采用可信国内镜像源可跳过此环节。
1、访问清华大学开源软件镜像站 Chromium 页面：
https://mirrors.tuna.tsinghua.edu.cn/chromium-browser-snapshots/Mac_Arm/
2、在页面中找到编号最大的文件夹（代表最新快照），进入后下载 chrome-mac.zip
3、解压后同上法拖入“应用程序”目录
4、为防止后续 Puppeteer 自动下载冲突，安装前请在项目根目录设置环境变量：
echo 'export PUPPETEER_SKIP_DOWNLOAD=true' >> ~/.zshrc && source ~/.zshrc
四、通过 Brew Cask 替代源安装（解决 freesmug-chromium 已弃用问题）
freesmug-chromium cask 已于 2023 年停止维护，当前主流 Homebrew 仓库默认启用官方 chromium cask。若旧配置残留导致安装异常，需清除缓存并强制切换源。
1、卸载可能存在的旧版本：
brew uninstall --cask freesmug-chromium
2、清理 Homebrew 缓存与旧公式：
brew cleanup && brew doctor
3、重新安装官方维护版本：
brew tap homebrew/cask-versions && brew install --cask chromium
4、验证安装结果：
ls /Applications/Chromium.app &>/dev/null && echo Chromium 已成功部署至应用程序目录 || echo "安装未完成，请检查终端输出"
五、终端命令行快速验证与调试（确认运行环境完整性）
安装完成后，可通过命令行检测 Chromium 是否可被系统识别、是否支持硬件加速及沙箱机制，这对自动化测试与 Puppeteer 集成至关重要。
1、在终端输入以下命令检查基础可执行性：
/Applications/Chromium.app/Contents/MacOS/Chromium --version
2、运行无头模式测试（不显示界面）：
/Applications/Chromium.app/Contents/MacOS/Chromium --headless --disable-gpu --dump-dom https://example.com
3、若返回 HTML 内容，说明核心功能正常；若提示“Operation not permitted”，需在系统设置 → 隐私与安全性 → 完全磁盘访问 → 启用 Chromium
4、检查沙箱状态（关键安全特性）：
/Applications/Chromium.app/Contents/MacOS/Chromium --no-sandbox --disable-gpu --headless --dump-dom https://example.com 2>&1 | grep -i sandbox
