直接用 brew install mysql@8.0 安装后，必须手动将二进制路径（apple silicon 为 /opt/homebrew/opt/mysql@8.0/bin，intel 为 /usr/local/opt/mysql@8.0/bin）加入 ~/.zshrc 的 $path 并重载，否则 mysql --version 报 command not found；还需启动服务、执行 mysql_secure_installation 或手动设 root 密码，并将认证插件改为 mysql_native_password，否则客户端连接失败。
能直接用 brew install mysql@8.0 装完就跑，但不配环境变量、不处理认证插件、不初始化密码，90% 的人卡在 mysql -u root -p 连不上这一步。
command not found: mysql 是路径没加进 shell
Homebrew 安装的 mysql@8.0 二进制文件不在系统默认 PATH 里，所以敲 mysql 会报错。Apple Silicon（M1/M2/M3）和 Intel 芯片路径不同，不能硬背：
- Apple Silicon 默认前缀是
/opt/homebrew，执行：echo 'export PATH="/opt/homebrew/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - Intel Mac 通常是
/usr/local，改用：echo 'export PATH="/usr/local/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 不确定芯片类型？运行
arch，输出arm64就是 Apple Silicon，x86_64是 Intel - 改完立刻验证：
mysql --version能打出mysql Ver 8.0.x才算生效
mysql_secure_installation 运行失败或无法设密码
MySQL 8.0+ 默认 root 用户无密码，但 mysql_secure_installation 要求强密码（至少 8 位，含大小写+数字+符号），且首次运行时服务必须已启动。常见卡点：
- 先确保服务在跑：
brew services start mysql@8.0，再执行mysql_secure_installation - 如果提示
Access denied for user 'root'@'localhost'，说明服务起来了但没初始化密码 —— 此时不能直接连，得先用sudo mysql -u root免密进库，然后手动设密码：ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourPass123!'; - 设完立刻退出并重试
mysql_secure_installation，它才能继续走流程 - 开发环境想跳过强密码校验？在
mysql_secure_installation第一步输入n，后续再设简单密码（如123456）
客户端连接报 Client does not support authentication protocol
这是 MySQL 8.0 默认用 caching_sha2_password 插件导致的，老版本 Python（mysqlclient）、Node.js（mysql2 旧版）、甚至某些 GUI 工具（DataGrip 旧版）都不支持。解决方式只有一条路：
- 进 MySQL 后执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'YourPass123!'; - 注意必须写全
'root'@'localhost'，只写'root'会创建新用户，原用户权限不受影响 - 执行
FLUSH PRIVILEGES;立即生效 - 验证是否生效：
SELECT host, user, plugin FROM mysql.user WHERE user = 'root';，确认plugin列是mysql_native_password
Can't connect to local MySQL server through socket 错误
这个错误不是密码问题，是客户端找不到 socket 文件路径。Homebrew 安装后默认 socket 在 /opt/homebrew/var/mysql/mysql.sock（Apple Silicon）或 /usr/local/var/mysql/mysql.sock（Intel），但客户端默认去找 /tmp/mysql.sock。
- 最稳方案：建
my.cnf配置文件，告诉客户端去哪找echo -e "[client]\nsocket = /opt/homebrew/var/mysql/mysql.sock" > /opt/homebrew/etc/my.cnf - Intel 用户把路径里的
/opt/homebrew换成/usr/local - 配置完重启服务：
brew services restart mysql@8.0 - 不建配置文件？临时连可用：
mysql -u root -p -S /opt/homebrew/var/mysql/mysql.sock
真正容易被忽略的是 socket 路径和认证插件这两处 —— 它们不报“密码错”，也不报“命令没找到”，而是用模糊错误把你绕晕。配完环境变量、跑通 mysql_secure_installation、切掉 caching_sha2_password、补上 my.cnf，才算闭环。中间漏任一环，后续所有连接、脚本、ORM 都会反复报错。
