必须下载macOS ARM64官方安装包，文件名含arm64、OS版本标明ARM/Apple Silicon，安装时选强密码加密，手动配置zsh环境变量，并修复data目录权限及端口冲突。
确认下载的是 macOS ARM64 官方安装包
Mac M1/M2/M3 芯片必须用 arm64 架构的安装包，否则会强制走 Rosetta 2 模拟，性能打七折、启动慢、部分插件不兼容。官网下载页上容易选错，关键看三点：
- 操作系统选 “
macOS”，不是 “macOS (x86, 64-bit)” - OS 版本下拉框里必须出现含 “
ARM”、“Apple Silicon” 或 “macOS 13/14/15 (ARM, 64-bit)” 字样的选项 - 文件名应类似
mysql-community-server-8.0.43-macos14-arm64.dmg或mysql-8.2.0-macos13-arm64.dmg—— 注意末尾是arm64，不是x86_64
如果只看到 “macOS 13 (x86, 64-bit)” 或文件名带 x86_64，说明你点进了 Intel 版本，得返回重选。
安装时跳过登录、注意身份验证方式
点击 Download 后，MySQL 官网会弹出 Oracle 账户登录页。直接点页面底部的 No thanks, just start my download. 即可，无需注册。安装过程中最关键的一步是 “Authentication Method”（身份验证方法）：
- 务必选
Use Strong Password Encryption (RECOMMENDED)—— 这是 MySQL 8.0+ 默认的caching_sha2_password插件，兼容现代客户端（如 MySQL Workbench 8.0+、DBeaver、Navicat 16+） - 别选 “Use Legacy Authentication Method”，虽然兼容老工具，但后续连不上新版本驱动，报错
Client does not support authentication protocol requested by server
选错后不能回退，只能重装；重装前需先彻底卸载：sudo /usr/local/mysql/support-files/mysql.server stop + 手动删掉 /usr/local/mysql 和 /Library/PreferencePanes/MySql.prefPane。
安装后 PATH 不自动生效，必须手动配置
DMG 图形化安装不会帮你加环境变量，所以终端里直接敲 mysql -u root -p 会提示 command not found。解决方法只有这一种可靠路径：
- 编辑 shell 配置文件：
echo 'export PATH="/usr/local/mysql/bin:$PATH"' >> ~/.zshrc（M1/M2 默认用 zsh） - 立即生效：
source ~/.zshrc - 验证：
which mysql应输出/usr/local/mysql/bin/mysql
别用 ~/.bash_profile（已弃用），也别改系统级 /etc/paths（权限麻烦且不推荐）。如果用了 Oh My Zsh 等框架，确保没在插件里覆盖了 PATH。
首次启动失败常见原因：端口被占或 data 目录权限不对
安装完双击 “Start MySQL Server” 图标没反应，或 sudo /usr/local/mysql/support-files/mysql.server start 报错退出，大概率是以下两个问题之一：
-
Can't start server: Bind on TCP/IP port: Address already in use：说明 3306 端口被占用，常见于之前装过 Homebrew MySQL、Docker 容器或另一个 MySQL 实例。查占用：lsof -i :3306，杀掉对应进程再试 -
mysqld: Can't create/write to file '/usr/local/mysql/data/xxx.err'：ARM 版安装后/usr/local/mysql/data目录属主可能是root，但服务以_mysql用户运行。修复：sudo chown -R _mysql:_mysql /usr/local/mysql/data
初始化密码藏在日志里：sudo cat /usr/local/mysql/data/*.err | grep "temporary password"，复制出来登录后立刻改密，别跳过这步 —— ARM 版对密码策略更严格，空密码或弱密码会被拒绝。
