brew install mysql 后终端找不到 mysql 命令，因 Homebrew 默认未将 MySQL 二进制路径（如 /opt/homebrew/opt/mysql@8.0/bin/）加入 $PATH，需手动添加至 ~/.zshrc 并重载配置。
brew install mysql 后为什么终端找不到 mysql 命令
因为 Homebrew 默认不把 MySQL 的二进制路径加进 $PATH，哪怕安装成功，mysql --version 也会报 command not found。
Homebrew 安装的 MySQL（如 mysql@8.0）实际可执行文件在：/opt/homebrew/opt/mysql@8.0/bin/（Apple Silicon）或 /usr/local/opt/mysql@8.0/bin/（Intel）。这个路径需要手动加入 shell 配置。
- 确认当前 shell 类型：
echo $SHELL，大概率是zsh - 编辑
~/.zshrc，追加一行：export PATH="/opt/homebrew/opt/mysql@8.0/bin:$PATH"（路径按brew --prefix mysql@8.0输出为准） - 重载配置：
source ~/.zshrc，再试mysql --version - 如果用的是
mysql（非带版本号的 formula），路径里去掉@8.0；注意 Homebrew 8.0+ 默认不再提供无版本号的mysql，推荐用mysql@8.0或mysql@8.4
mysql.server start 报错 “The server quit without updating PID file”
这是 MySQL 服务启动失败最典型的错误，根本原因通常是数据目录权限不对、配置冲突，或残留的 mysqld.pid 文件没清理干净。
Homebrew 安装后首次启动必须先初始化数据目录，不能直接 mysql.server start。
- 先运行初始化命令：
mysql_install_db --datadir=/opt/homebrew/var/mysql（路径以brew --prefix+/var/mysql为准） - 检查
/opt/homebrew/var/mysql/所有文件属主是否为当前用户：ls -la /opt/homebrew/var/mysql，如果不是，执行sudo chown -R $(whoami) /opt/homebrew/var/mysql - 删掉可能残留的 pid 文件：
rm -f /opt/homebrew/var/mysql/*.pid - 再启动：
mysql.server start，不是brew services start mysql@8.0—— 后者会绕过本地配置，容易掩盖问题
brew services start mysql@8.0 不生效或自动退出
brew services 管理的是后台守护进程，它依赖 launchd 配置，而 MySQL 的 launchd plist 文件默认不会启用 socket 监听，或与系统已有 MySQL 冲突（比如之前用官方 DMG 装过）。
常见表现：运行 brew services start mysql@8.0 后立刻显示 started，但 ps aux | grep mysqld 查不到进程，或 mysql -u root 连不上。
- 先停掉所有可能的 mysqld：
mysql.server stop和brew services stop mysql@8.0 - 检查端口占用：
lsof -i :3306，如有残留进程，kill -9干掉 - 确认
my.cnf配置位置：mysql --help | grep "Default options"，Homebrew 默认读/opt/homebrew/etc/my.cnf；若该文件存在但内容为空或错配，删掉重建 - 最小化测试启动：
mysqld --defaults-file=/opt/homebrew/etc/my.cnf --user=$(whoami) --datadir=/opt/homebrew/var/mysql --port=3306 --socket=/tmp/mysql.sock，看是否报错
连接时报错 “Access denied for user 'root'@'localhost' (using password: NO)”
Homebrew 安装的 MySQL 8.0+ 默认禁用空密码 root 登录，且 root 用户默认只允许 socket 认证（即不走密码），所以 mysql -u root 会失败，除非显式指定 socket。
这不是密码错了，是认证方式不匹配。别急着重置密码，先确认你连的是哪个实例。
- 优先用 socket 连：
mysql -u root --socket=/tmp/mysql.sock（路径以mysql --help | grep socket输出为准） - 如果仍拒绝，说明初始化时没生成 root 密码提示 —— 可临时跳过密码验证启动：
mysqld --skip-grant-tables --skip-networking &，然后连上执行ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'your_new_pass'; - Mac 上更稳妥的做法：初始化时就记录初始密码 ——
mysql_secure_installation第一步会提示 “Your password is stored temporarily”，务必抄下来 - 避免后续混乱：连本地库统一用
mysql -S /tmp/mysql.sock -u root，而不是-h 127.0.0.1（后者走 TCP，触发密码验证）
MySQL 在 Homebrew 下不是“装完就能用”的黑盒，路径、权限、socket、认证方式这四块只要有一处没对齐，就会卡在某个看似随机的环节。尤其要注意 Intel 和 Apple Silicon 的 brew --prefix 路径差异，以及 mysql@8.0 和 mysql 公式已实质分家的事实。
