能装mysql@8.4，需先确认Homebrew已安装且为Apple Silicon适配版本（/opt/homebrew、arm64），再执行brew install mysql@8.4；安装后必须brew services start mysql@8.4，并通过mysql -u root --skip-password初始化root密码，最后将/opt/homebrew/opt/mysql@8.4/bin加入PATH确保调用正确版本。
能装，但别直接 brew install mysql —— 默认会装最新版（可能是 8.5+），而 MySQL 8.4 是当前最稳定、兼容性最好的 LTS 级别版本，且 Homebrew 明确提供了 mysql@8.4 这个 formula。
确认你的 Mac 是 Apple Silicon（M1/M2/M3）并已装好 Homebrew
Homebrew 在 M 系列芯片上默认安装路径是 /opt/homebrew，MySQL 的二进制和数据目录都会落在此下。如果还没装 Homebrew，终端运行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
装完后验证：
-
brew --version应输出类似Homebrew 4.6.10 -
arch应输出arm64（不是i386或x86_64）
若已装旧版 Homebrew（比如 Intel 路径下的），建议先清理再重装，否则 mysql@8.4 可能链接到错误的 lib 路径。
安装 mysql@8.4 而不是 mysql
Homebrew 对不同 MySQL 版本做了分离管理：mysql 指向最新主版本（2026 年底已是 8.5.x），而 mysql@8.4 是独立 formula，带完整依赖锁（如 openssl@3、icu4c），避免编译时因依赖漂移失败。
执行：
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
brew install mysql@8.4
常见误区：
- 不要用
brew search mysql后手动选mysql@8.4—— 它通常就在第一行，但搜索结果可能混入废弃 formula（如mysql-client） - 不要加
--build-from-source：Homebrew 已为 macOS 14+（Sequoia）和 macOS 13（Ventura）提供预编译 bottle，M 系列可直接下载，全程无需编译 LLVM - 若提示
Error: mysql@8.4 has been disabled，说明你用了国内镜像源（如 HomebrewCN）且未同步上游，换回官方源：brew tap-default homebrew/core
启动服务 + 初始化 root 密码（MySQL 8.4 默认禁用空密码）
Homebrew 不会自动运行初始化脚本，mysql@8.4 安装后首次启动时，mysqld 会自动生成数据目录（/opt/homebrew/var/mysql），但 root 用户仍无密码、认证插件是 caching_sha2_password，直接 mysql -u root 会报 Access denied。
正确流程：
- 启动服务：
brew services start mysql@8.4（不是mysql） - 连进去：
mysql -u root --skip-password（8.4 支持该 flag 绕过密码校验） - 在 MySQL 提示符下执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_strong_password'; - 再执行：
FLUSH PRIVILEGES;
注意：mysql_secure_installation 在 mysql@8.4 中默认不可用（它绑定在 mysql formula 的 bin 下），硬调会报 command not found。
PATH 和客户端命令的实际位置
Homebrew 安装的 mysql@8.4 二进制不在 /opt/homebrew/bin，而在 /opt/homebrew/opt/mysql@8.4/bin。这意味着：
-
mysql --version可能报 command not found，除非你手动加了 PATH - 推荐做法：运行
echo 'export PATH="/opt/homebrew/opt/mysql@8.4/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 验证：
which mysql应输出/opt/homebrew/opt/mysql@8.4/bin/mysql
容易被忽略的是：如果你之前装过 mysql（非 @8.4），它的 mysql 命令可能还留在 PATH 里，导致你以为连的是 8.4，实际是 8.5 —— 查版本一定要用 mysql --version，而不是只信服务名。
