homebrew安装mysql后必须手动初始化数据目录、配置socket路径并使用临时密码登录改密。具体包括：执行mysqld --initialize初始化；创建/usr/local/etc/my.cnf指定socket路径；用临时密码登录后立即执行alter user改密。
brew install mysql 这条命令本身没错，但直接执行它大概率会卡住、报错，或装完无法启动——不是命令有问题，是 macOS 上 Homebrew 安装 MySQL 的实际路径里埋了几个必须手动处理的坑。
检查 Homebrew 和残留 MySQL 实例
很多人跳过这步，结果 brew install mysql 报 Error: mysql: no bottle available 或启动时提示 Can't connect to local MySQL server。先确认两点：
- 运行
brew --version，确保输出类似Homebrew 4.6.10；没装就跑/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 运行
brew list | grep mysql，如果输出mysql或mysql@5.7，必须先brew uninstall mysql（含旧版本），否则新安装会冲突或静默失败 - 顺手清一下缓存：
brew cleanup，避免旧 formula 干扰
安装后必须初始化 data 目录
Homebrew 安装的 MySQL 不会自动创建 /usr/local/var/mysql 下的初始数据目录，这是 macOS 上最常导致 brew services start mysql 启动失败的根本原因。
正确做法是安装完立刻手动初始化：
- 运行
mysql_install_db --verbose --user=$(whoami) --basedir="$(brew --prefix mysql)" --datadir=/usr/local/var/mysql --tmpdir=/tmp - 或者更稳妥（尤其 Apple Silicon）：
mysqld --initialize --user=$(whoami) --basedir="$(brew --prefix mysql)" --datadir=/usr/local/var/mysql --tmpdir=/tmp - 注意：这条命令只执行一次，成功后会打印临时 root 密码（形如
A temporary password is generated for root@localhost: xxxxxx），务必复制保存
启动服务前要改默认配置（尤其 macOS 15+）
macOS 15 Sequoia 及更新系统对 socket 路径更严格，Homebrew 默认配置仍指向 /tmp/mysql.sock，但新版系统可能拒绝写入该路径，导致客户端连接报 Can't connect to local MySQL server through socket '/tmp/mysql.sock'。
解决方法是覆盖默认配置：
- 创建配置文件：
echo '[mysqld]\nsocket=/usr/local/var/mysql/mysql.sock' > /usr/local/etc/my.cnf - 确保目录可写：
sudo chown -R $(whoami) /usr/local/var/mysql - 再启动：
brew services start mysql，此时日志应显示mysqld is ready
首次登录必须用临时密码 + 立即改密
别信 mysql -uroot -p 然后直接回车——新版 MySQL（8.0+）强制要求用初始化时生成的临时密码登录，且首次登录后必须立刻重置密码，否则后续任何操作都报 Your password has expired。
流程是：
-
mysql -uroot -p→ 粘贴刚才记下的临时密码 - 进 MySQL 后立即执行：
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的强密码'; - 退出后就能用新密码正常连了：
mysql -uroot -p
容易被忽略的是：Apple Silicon（M1/M2/M3）芯片 Mac 上，brew install mysql 拉的是 arm64 架构包，但部分老项目依赖 x86 工具链，若后续编译出错，得留意是否混用了 Rosetta 终端——所有操作务必在原生终端里完成。
