mac上mysql安装配置有三路径：一、dmg图形化安装需勾选传统密码加密并配置path；二、homebrew安装更适开发者，含安全初始化；三、手动调试可解决命令未识别、连接拒绝及插件不兼容等问题。
如果您希望在Mac系统上完成MySQL数据库的安装与完整配置，但遇到命令不可识别、服务无法启动或客户端连接失败等问题，则可能是由于安装方式选择不当、环境变量未生效、密码加密方式不兼容或权限配置缺失所致。以下是多种可行的安装与配置路径：
一、使用官方DMG安装包（图形化安装）
该方法适合初学者，提供直观的安装向导和系统偏好设置面板，便于服务启停管理，但需手动配置环境变量并注意密码加密兼容性。
1、访问MySQL官网 https://dev.mysql.com/downloads/mysql/，滚动至页面底部，选择适用于 macOS 14+（x86-64 或 ARM64）的 DMG Archive 文件下载。
2、双击下载的 .dmg 文件，再双击其中的 .pkg 安装包，按提示点击“继续”直至完成。
3、安装过程中，在设置 root 密码步骤务必勾选 Use Legacy Password Encryption，避免后续 Navicat、Sequel Pro 或部分 Python 驱动连接报错。
4、安装完成后，打开“系统设置”→ 底部“MySQL”，确认服务状态为绿色圆点；若未运行，点击“Start MySQL Server”启动。
5、打开终端，执行 sudo vim ~/.zshrc（macOS Catalina 及之后默认 shell 为 zsh；如为旧版 bash，请改用 ~/.bash_profile）。
6、按 i 进入编辑模式，在文件末尾新增一行：export PATH="/usr/local/mysql/bin:$PATH"。
7、按 Esc 退出编辑，输入 :wq 保存退出；再执行 source ~/.zshrc 使配置立即生效。
8、验证安装：终端输入 mysql --version 应返回版本号；再执行 mysql -u root -p，输入安装时设定的密码，成功进入 MySQL 提示符即表示可用。
二、使用Homebrew命令行安装（推荐开发者）
该方式自动化程度高，支持版本管理与服务生命周期控制，集成安全初始化流程，适合熟悉终端操作的用户。
1、若尚未安装 Homebrew，先在终端执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、安装完成后，运行 brew doctor 确认环境正常。
3、执行 brew install mysql 安装最新稳定版 MySQL 及其依赖。
4、安装完毕后，运行 brew services start mysql 启动服务并设置开机自启。
5、立即执行 mysql_secure_installation 进行安全加固：设置 root 密码、移除匿名用户、禁止 root 远程登录、删除 test 数据库等。
6、验证连接：终端输入 mysql -u root -p，输入刚设定的密码即可登录。
7、如需切换为本地 socket 连接（避免 10061 错误），可检查 /opt/homebrew/etc/my.cnf（Apple Silicon）或 /usr/local/etc/my.cnf（Intel）中 socket 路径是否匹配 /tmp/mysql.sock。
三、手动配置与故障应对（进阶调试）
当出现 command not found: mysql、Access denied for user 'root'@'localhost' 或客户端身份验证失败时，需针对性介入底层配置。
1、确认 MySQL 二进制路径是否存在：ls -l /usr/local/mysql/bin/mysql（DMG 方式）或 ls -l $(brew --prefix mysql)/bin/mysql（Homebrew 方式）。
2、若 PATH 配置无误但仍报错，尝试显式调用：/usr/local/mysql/bin/mysql -u root -p（DMG）或 $(brew --prefix mysql)/bin/mysql -u root -p（Homebrew）。
3、重置遗忘的 root 密码：先停止服务，然后以跳过权限表模式启动：sudo /usr/local/mysql/support-files/mysql.server stop，再执行 sudo /usr/local/mysql/bin/mysqld_safe --skip-grant-tables &；随后另开终端，运行 mysql -u root，执行 ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'newpass';，最后重启服务。
4、解决 caching_sha2_password 不兼容问题：登录后执行 SELECT host, user, plugin FROM mysql.user;，若 root 用户 plugin 显示为 caching_sha2_password，执行 ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; 并刷新权限：FLUSH PRIVILEGES;。
5、验证 socket 连接路径：执行 mysql --socket=/tmp/mysql.sock -u root -p；若成功，说明客户端默认 socket 路径不一致，可在 ~/.my.cnf 中添加：[client]\nsocket = /tmp/mysql.sock。
