测试发布文章功能，测试文章内嵌代码快功能，测试封面功能

MySQL 是日常开发中最常用的关系型数据库之一，在 macOS 系统下安装 MySQL 有两种主流方式：Homebrew 一键安装（推荐开发人员，易管理、免手动配置）和官方 DMG 包安装（适合需要自定义安装路径的场景），本文会详细讲解两种方法的完整步骤，适配最新的 macOS Sonoma/Ventura 系统，无论是新手还是有经验的开发者都能轻松上手。

前置说明

本文适配 macOS 全系列系统（Intel/Apple Silicon 芯片均支持），安装完成后可直接用于本地开发、项目调试，后续可搭配 Navicat、DBeaver 等可视化工具使用，步骤中会标注关键注意点（如 MySQL8.0+ 密码配置），避免踩坑。

方法一：Homebrew 安装（推荐，开发首选）

Homebrew 是 macOS 专属的包管理器，能一键完成 MySQL 的安装、依赖处理、服务管理，无需手动配置环境变量，后续升级、卸载也非常方便，是后端开发的最优选择。

步骤 1：检查 / 安装 Homebrew

如果你的电脑已经安装了 Homebrew，可直接跳过此步骤；未安装的话，打开终端（Launchpad → 其他 → 终端），执行以下命令一键安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，验证是否成功（终端输出版本号即表示安装正常）：

brew -v

步骤 2：安装 MySQL

终端执行以下命令，Homebrew 会自动下载适配你电脑芯片的 MySQL 最新稳定版（目前默认 8.0+ 版本），并自动处理所有依赖：

brew install mysql

等待终端提示 “Installation successful” 即安装完成，全程无需手动操作。

步骤 3：启动 MySQL 服务并设置开机自启

MySQL 在 macOS 中以后台服务运行，执行以下命令启动服务，并设置开机自启（避免每次重启电脑后重新启动，开发场景必备）：

# 启动 MySQL 服务
brew services start mysql

验证服务是否启动成功（终端列表中 mysql 后标注「started」即正常）：

brew services list

后续如需停止 / 重启服务，可执行：

# 停止服务
brew services stop mysql
# 重启服务
brew services restart mysql

步骤 4：初始化密码（MySQL8.0+ 必做）

MySQL8.0+ 安装后默认无 root 密码，但直接连接会触发安全验证，必须执行初始化命令配置密码和安全项，终端执行：

mysql_secure_installation

执行后终端会分步引导配置，按以下提示操作即可（新手直接按推荐选择，全程回车 + 输入 Y 即可）：

  1. 首次提示「Enter password for user root:」：当前无密码，直接回车；

  2. 询问「Set root password?」：输入Y，然后设置自己的密码（终端输入密码时不显示光标，正常输入即可，建议字母 + 数字组合），重复密码确认；

  3. 后续依次询问：删除匿名用户（Y）、禁止 root 远程登录（新手选 Y，后续需要可再开启）、删除 test 数据库（Y）、刷新权限（Y）。

步骤 5：连接 MySQL 测试安装

终端执行以下命令，输入刚才设置的 root 密码，成功进入 MySQL 命令行即表示安装完成：

mysql -u root -p

进入后终端会显示「mysql>」提示符，执行以下 SQL 验证（注意分号结尾，MySQL 命令必须以分号结束）：

# 查看默认数据库列表
show databases;

若终端输出 mysql、information_schema 等默认数据库，说明一切正常。后续退出 MySQL 命令行可执行：

exit;

方法二：官方 DMG 安装包（自定义安装，适合特殊需求）

如果不想使用 Homebrew，或需要自定义 MySQL 安装路径，可选择官方 DMG 安装包，步骤稍多但可控性更强，适合对安装路径有要求的场景。

步骤 1：下载官方安装包

打开 MySQL 官方下载地址：https://dev.mysql.com/downloads/mysql/

  1. 系统选择macOS，安装包类型选择DMG Archive（会自动适配 Intel/Apple Silicon 芯片）；

  2. 无需登录 / 注册，直接点击No thanks, just start my download. 开始下载。

步骤 2：安装 MySQL 程序

  1. 打开下载的 DMG 包，双击mysql-installer-community-x.x.x.pkg开始安装；

  2. 全程按「继续→同意→安装」操作，安装类型选择默认即可，无需修改路径；

安装完成后，会弹出临时密码窗口（关键！），复制并保存该密码（后续修改密码需要），若不小心关闭，可在终端执行以下命令查看临时密码：

cat /usr/local/mysql/data/$(hostname).err | grep 'temporary password'

步骤 3：配置环境变量（可选，方便终端直接调用）

默认安装后，mysql 命令不在系统环境变量中，终端无法直接执行，需手动配置（配置后可在任意目录连接 MySQL，推荐配置）：

查看你的终端类型（默认 macOS 新系统为 zsh，旧系统为 bash），终端执行：

echo $SHELL

输出「/bin/zsh」为 zsh 终端，输出「/bin/bash」为 bash 终端；

编辑配置文件，终端执行对应命令：

# zsh 终端
open ~/.zshrc
# bash 终端
open ~/.bash_profile

在配置文件末尾添加以下内容，保存并关闭文件：

export PATH=/usr/local/mysql/bin:$PATH
export PATH=/usr/local/mysql/support-files:$PATH

让环境变量立即生效，终端执行对应命令：

# zsh 终端
source ~/.zshrc
# bash 终端
source ~/.bash_profile

步骤 4：启动 MySQL 服务

两种启动方式可选，新手推荐图形化启动，更直观；开发人员可选择终端启动，更高效。

方式 1：图形化启动（新手推荐）

  1. 打开 macOS 系统偏好设置，拉到最下方会看到MySQL图标，点击进入；

  2. 点击Start MySQL Server启动服务，勾选Automatically Start MySQL Server on Startup设置开机自启；

  3. 服务启动后，左侧指示灯会变为绿色，表示启动成功。

方式 2：终端启动

终端执行以下命令（执行 sudo 需输入电脑开机密码，不是 MySQL 密码）：

# 启动服务
sudo mysql.server start
# 停止服务
sudo mysql.server stop
# 重启服务
sudo mysql.server restart

步骤 5：修改临时密码（必做）

官方安装包的临时密码仅用于首次连接，必须修改为自定义密码才能正常使用，步骤如下：

终端执行连接命令，输入之前保存的临时密码：

mysql -u root -p

进入 MySQL 命令行后，执行以下 SQL 修改密码（将your_new_password替换为你的自定义密码）：

ALTER USER 'root'@'localhost' IDENTIFIED BY 'your_new_password';
# 刷新权限，使密码修改生效
FLUSH PRIVILEGES;

执行exit;退出命令行，重新用新密码连接即可正常使用。

常用 MySQL 管理命令（两种安装方法通用）

无论你用哪种方法安装，后续日常管理 MySQL 的核心命令都是一致的，收藏备用，开发效率翻倍：

# 查看 MySQL 版本
mysql --version

# 连接 MySQL 本地服务
mysql -u root -p

# Homebrew 安装版 - 服务管理
brew services start mysql  # 启动
brew services stop mysql   # 停止
brew services restart mysql# 重启
brew services list        # 查看服务状态

# 官方安装版 - 服务管理
sudo mysql.server start   # 启动
sudo mysql.server stop    # 停止
sudo mysql.server restart # 重启
sudo mysql.server status  # 查看服务状态

常见问题解决（避坑指南）

安装过程中可能会遇到一些小问题，以下是最常见的 3 个问题及解决方法，遇到时直接对照处理即可：

问题 1：连接时提示「Access denied for user 'root'@'localhost'」

  • 原因：密码错误，或未完成密码初始化（Homebrew 版）/ 未修改临时密码（官方版）；

  • 解决：Homebrew 版重新执行mysql_secure_installation初始化密码，官方版用临时密码连接后重新修改密码。

问题 2：MySQL 服务启动失败，提示端口被占用

原因：MySQL 默认端口 3306 被其他程序（如旧版 MySQL、Navicat 代理）占用；

解决：终端执行以下命令杀死占用进程，再重新启动服务：

# 查看 3306 端口占用进程
lsof -i:3306
# 杀死进程（将 PID 替换为上一步输出的进程号）
kill -9 PID

问题 3：系统偏好设置中无 MySQL 图标（官方版）

  • 原因：安装包未完成配置，或安装路径被修改；

  • 解决：删除现有安装文件，重新下载官方最新 DMG 包，全程选择默认路径安装。

总结

  1. 开发场景首选 Homebrew 安装：一键操作、免手动配置环境，后续服务管理、升级卸载都非常方便，适配 99% 的本地开发需求；

  2. 官方 DMG 包适合自定义需求：步骤稍多，但可自主控制安装路径，适合对系统环境有特殊要求的场景；

  3. 核心关键步骤：无论哪种方法，都必须完成「安装→启动服务→设置 / 修改密码→连接测试」，其中 MySQL8.0+ 的密码配置是必做项，无密码无法正常连接；

  4. 安装完成后，推荐搭配可视化工具（如 DBeaver、Navicat）使用，比终端操作更直观，适合日常建库、写 SQL、调试数据。

至此，macOS 下的 MySQL 就安装完成了，接下来就可以在本地搭建项目，连接数据库进行开发了。如果后续需要配置 MySQL 远程连接、修改默认端口、搭建主从复制等，我会继续更新相关教程～