推荐使用homebrew安装mysql 8.0而非官网.dmg包，因其原生适配apple silicon架构，自动配置路径（/opt/homebrew）、服务（brew services start mysql@8.0）及权限，避免socket错位、启动失败和命令未找到等问题。
直接用 brew install mysql@8.0，别碰官网 .dmg 包——除非你明确需要图形化向导或必须绕过 Homebrew 管理。
为什么默认走 Homebrew 而不是官网安装包？
Apple Silicon（M1/M2/M3）上，Homebrew 安装的 mysql@8.0 是原生 ARM64 构建，路径、权限、服务注册全部适配 macOS 新安全模型；而官网 .dmg 包虽也提供 ARM 版本，但安装后常出现 socket 路径错位、launchctl 启动失败、或 mysql 命令找不到的问题，根源是它默认写死 Intel 风格路径（如 /usr/local/mysql），且不自动配置 PATH 或服务 plist。
Homebrew 则把所有内容放进 /opt/homebrew/Cellar/mysql@8.0/x.x.x/，并生成标准 launch agent，启动命令 brew services start mysql@8.0 一次生效。
使用 inotes CLI 从终端管理 Apple Notes。当需要在 macOS 的 Notes.app 中列出、读取、创建、编辑、删除或搜索备忘录时使用。
- 已装过 MySQL 9.x？没关系，
mysql@8.0和mysql（默认指向最新版）互不干扰，可用brew link --force mysql@8.0切换当前 shell 的默认版本 - 没装 Homebrew？先跑
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，再brew update - 旧版 MySQL 残留？执行
brew uninstall mysql mysql@5.7（如有），避免brew services冲突
安装后必须做的三件事
Homebrew 安装完只完成二分之一——剩下的是初始化、密码设置和权限校准，缺一不可，否则 mysql -u root -p 会卡住或报 Access denied。
- 运行
mysql_secure_installation：它会引导你设置 root 密码、禁用匿名用户、禁止远程 root 登录、删除测试库——这步不能跳，MySQL 8.0 默认启用caching_sha2_password认证插件，空密码或旧插件会导致客户端连接失败 - 检查 socket 路径：Homebrew 默认 socket 在
/opt/homebrew/var/mysql/mysql.sock，但很多 GUI 工具（如 TablePlus、Navicat）默认找/tmp/mysql.sock。解决方法是加软链：ln -sf /opt/homebrew/var/mysql/mysql.sock /tmp/mysql.sock - 确认环境变量：安装提示里会说“add to PATH”，手动执行
echo 'export PATH="/opt/homebrew/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc，否则终端打mysql --version会提示 command not found
连不上？先看这四个常见错误信号
不是所有“连接失败”都该重装——多数是配置偏差，按顺序排查比重来快得多：
-
Can't connect to local MySQL server through socket '/tmp/mysql.sock'→ socket 路径不对，按上一条加软链，或在连接时显式指定：mysql -u root -p --socket=/opt/homebrew/var/mysql/mysql.sock -
Access denied for user 'root'@'localhost'→ 说明认证插件或密码没设好，重跑mysql_secure_installation，过程中选“Use Strong Password Encryption”，别选兼容模式 - Navicat / TablePlus 报
Authentication plugin 'caching_sha2_password' cannot be loaded→ 客户端太老，升级到 Navicat 17+ 或 TablePlus 5+；或临时降级认证方式（不推荐）：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'yourpass'; - 系统偏好设置里 MySQL 图标红绿闪烁 → 实际是
homebrew.mxcl.mysql@8.0.plist启动失败，查日志：brew services list看状态，再tail -f /opt/homebrew/var/log/mysql/error.log找具体错误（常见是数据目录权限不对，执行sudo chown -R $(whoami) /opt/homebrew/var/mysql）
最易被忽略的点是：Homebrew 安装的 mysql@8.0 不会自动创建 ~/.my.cnf，而很多工具依赖它存默认 host/user/port。如果频繁输参数，建议手动建一个：echo "[client]\nuser = root\npassword = yourpass\nsocket = /opt/homebrew/var/mysql/mysql.sock" > ~/.my.cnf，并 chmod 600 ~/.my.cnf。
