必须用 brew install mysql@8.0 并确保 Homebrew 运行在 ARM 原生模式下,即 which brew 输出 /opt/homebrew/bin/brew、arch 输出 arm64、PATH 正确配置为 /opt/homebrew/opt/mysql@8.0/bin,且初始化后执行 ALTER USER ... IDENTIFIED WITH mysql_native_password。

必须用 brew install mysql@8.0,且确保 Homebrew 运行在 ARM 原生模式下,否则装出来的不是真 Apple Silicon 版 —— 后续连接失败、Navicat 报错、Laravel Sail 启动卡住,全源于这一步没对齐。
确认 Homebrew 是 ARM 原生安装的
很多人以为装了 Homebrew 就万事大吉,其实 M 系列芯片上存在 Intel 版和 Apple Silicon 版两套 Homebrew,路径和架构完全不同:
-
which brew必须输出/opt/homebrew/bin/brew;如果看到/usr/local/bin/brew,说明你装的是 Intel 版,得重装 -
arch必须输出arm64;如果输出i386或x86_64,说明终端正通过 Rosetta 运行 —— 右键「终端」→「显示简介」→取消勾选「使用 Rosetta 运行」 - 执行
brew update && brew upgrade,确保 formula 是最新 ARM 适配版(截至 2026 年 10 月,mysql@8.0仍在维护)
安装 mysql@8.0 并验证是否 ARM 原生
别用 brew install mysql,它可能拉取 8.4 或更高主干版,而旧工具链(如 Navicat 16、Laravel Sail v9)对 caching_sha2_password 插件支持不稳定:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 运行
brew search mysql@8.0确认可用 - 执行
brew install mysql@8.0(不是mysql) - 启动服务:
brew services start mysql@8.0 - 验证架构:
/opt/homebrew/opt/mysql@8.0/bin/mysql -V,输出中必须含macos22-arm64或类似字样,绝不能出现x86_64
PATH 没配对 → mysql 命令找不到
Homebrew 不会自动把 MySQL 二进制路径加进 $PATH,这是最常卡住的环节 —— 不是没装好,是 shell 找不到命令:
- Apple Silicon 路径固定为:
/opt/homebrew/opt/mysql@8.0/bin/ - 执行:
echo 'export PATH="/opt/homebrew/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 立刻验证:
mysql --version能打出mysql Ver 8.0.x才算生效 - 别跳过这步:后续所有操作(包括
mysql_secure_installation、客户端连接)都依赖这个命令可用
初始化 root 密码与降级认证插件
MySQL 8.0 默认启用 validate_password 和 caching_sha2_password,直接跑 mysql_secure_installation 会报 ERROR 1819 (HY000) 或连接拒绝:
- 先停服务:
brew services stop mysql@8.0 - 手动初始化(关键!用
--initialize-insecure):/opt/homebrew/opt/mysql@8.0/bin/mysqld --initialize-insecure --user=$(whoami) --basedir=/opt/homebrew/opt/mysql@8.0 --datadir=/opt/homebrew/var/mysql@8.0 - 重启服务:
brew services start mysql@8.0 - 免密登录:
mysql -u root,然后立即执行:ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456'; - 开发环境可跳过强密码校验:在
mysql_secure_installation第一步输n,后续设简单密码
真正容易被忽略的点是三者必须同时对齐:ARM 架构路径 + 正确的 mysql@8.0 公式 + mysql_native_password 插件。漏掉任一环,Navicat、Sequel Ace、Docker 容器内连接都会静默失败,错误日志里往往只写 “Access denied”,实际根源藏在这三处配置里。

















