mysql命令找不到、连不上root、客户端报authentication protocol错误，90%因path未配置、认证插件不匹配（caching_sha2_password→mysql_native_password）或服务未启动，而非安装失败。
MySQL 命令找不到、连不上 root、客户端报 authentication protocol 错误——这三类问题，90% 都是因为没配对 PATH、没切对认证插件、没启动服务，而不是装错了。
mysql: command not found 是路径没加进 shell
Homebrew 安装的 mysql@8.0 二进制文件默认不在系统 $PATH 里。Apple Silicon（M1/M2/M3）和 Intel 路径不同，不能硬记：
- 先确认芯片架构：
arch输出arm64→ Apple Silicon；输出x86_64→ Intel - Apple Silicon：执行
echo 'export PATH="/opt/homebrew/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - Intel：执行
echo 'export PATH="/usr/local/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 验证是否生效：
mysql --version能打出mysql Ver 8.0.x才算成功
mysql -u root -p 连不上，大概率是认证插件不兼容
MySQL 8.0+ 默认用 caching_sha2_password 插件，但老版本 Navicat、Laravel Sail、某些 JDBC 驱动不支持。必须手动降级：
- 先确保服务已运行：
brew services start mysql@8.0 - 免密登录：
sudo mysql -u root（注意不是mysql -u root -p） - 执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'YourPass123!'; - 退出后重试：
mysql -u root -p，输入刚设的密码 - 如果要用普通用户连接，同样需对对应用户执行
IDENTIFIED WITH mysql_native_password
brew install mysql@8.0 后服务起不来，检查 Homebrew 是否原生运行
M2 芯片上如果 Homebrew 是 Intel 版或终端跑在 Rosetta 下，会装出 x86_64 兼容包，导致启动失败或性能异常：
- 运行
which brew：输出必须是/opt/homebrew/bin/brew；如果是/usr/local/bin/brew，说明装错了，得重装 - 运行
arch：必须是arm64；若为i386或x86_64，关掉终端，右键「终端」→「显示简介」→取消勾选「使用 Rosetta 运行」 - 安装前先更新：
brew update && brew upgrade，再执行brew install mysql@8.0 - 启动失败时看日志：
tail -20 /opt/homebrew/var/mysql/*.err，常见原因是server_id未配置，需在/opt/homebrew/etc/my.cnf中补全[mysqld]段并设server-id = 1
想跳过 mysql_secure_installation？直接初始化密码更可控
该命令对密码强度要求高（至少 8 位含大小写+数字+符号），开发环境没必要卡在这一步：
- 服务启动后，用
sudo mysql -u root登录 - 执行：
ALTER USER 'root'@'localhost' IDENTIFIED BY '123456'; - 再执行：
FLUSH PRIVILEGES; - 退出后即可用
mysql -u root -p连入，密码为123456 - 如果后续要用图形客户端，记得同步改认证插件（见第二部分）
真正容易被忽略的是：PATH 配错芯片类型、认证插件没改、以及 Homebrew 架构错位——这三个点只要一个没对齐，整个 MySQL 就处于“看似装了，实则不能用”的状态。
