在 macOS 上安装 MySQL 服务的详细步骤

以下是在 macOS 上安装 MySQL 服务的详细步骤，涵盖两种常用方法（手动安装和 Homebrew 安装）：

方法一：通过官网下载安装包（推荐新手）

1. 下载 MySQL 社区版

1. 访问 MySQL 官网下载页面：

   https://dev.mysql.com/downloads/mysql/

2. 选择 macOS 系统，下载对应的 DMG 安装包（如 mysql-8.0.xx-macos13-arm64.dmg）。

2. 安装 MySQL

1. 双击下载的 .dmg 文件，打开安装向导。
2. 按提示完成安装，注意以下关键步骤：
   • 选择安装类型：默认安装即可（包含 MySQL Server 和命令行工具）。
   • 设置 root 密码：安装最后一步会提示设置 root 用户密码，务必牢记。

3. 启动与验证服务

1. 启动 MySQL 服务：
   • 打开 系统偏好设置 → 找到 MySQL 图标 → 点击 Start MySQL Server。
   • 验证安装：

     # 检查 MySQL 版本
     mysql --version
     # 登录 MySQL（使用设置的 root 密码）
     mysql -u root -p
     

方法二：通过 Homebrew 安装（推荐开发者）

1. 安装 Homebrew（如未安装）

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

2. 安装 MySQL

# 更新 Homebrew
brew update
# 安装 MySQL
brew install mysql

3. 启动与配置服务

1. 启动 MySQL 服务：

   brew services start mysql
   

2. 安全初始化（设置 root 密码等）：

   mysql_secure_installation
   

   • 按提示操作：设置密码、删除匿名用户、禁止远程 root 登录等。

4. 验证登录

mysql -u root -p

通用配置与管理

1. 配置环境变量（可选）

若出现 mysql: command not found，需将 MySQL 路径添加到环境变量：

# 编辑配置文件（如 ~/.zshrc 或 ~/.bash_profile）
echo 'export PATH="/usr/local/mysql/bin:$PATH"' >> ~/.zshrc
# 应用配置
source ~/.zshrc

2. 常用命令

# 启动服务
brew services start mysql    # Homebrew 安装
sudo /usr/local/mysql/support-files/mysql.server start  # 手动安装
# 停止服务
brew services stop mysql
sudo /usr/local/mysql/support-files/mysql.server stop
# 重启服务
brew services restart mysql
sudo /usr/local/mysql/support-files/mysql.server restart

3. 修改配置文件

• 配置文件路径：/usr/local/mysql/my.cnf 或 /etc/my.cnf（手动安装可能需要自行创建）。
• 示例配置（调整内存、字符集等）：

  [mysqld]
  character-set-server=utf8mb4
  default-authentication-plugin=mysql_native_password
  

  ---

  常见问题解决

  1. 忘记 root 密码

  1. 停止 MySQL 服务：

     sudo /usr/local/mysql/support-files/mysql.server stop
     

  2. 进入安全模式：

     sudo mysqld_safe --skip-grant-tables
     

  3. 新终端登录并重置密码：

     mysql -u root
     # 执行 SQL
     ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_password';
     FLUSH PRIVILEGES;
     

  2. 端口冲突（默认 3306）

  # 查看占用端口的进程
  lsof -i :3306
  # 终止冲突进程
  kill -9 
  

  ---

  图形化管理工具推荐

  • MySQL Workbench：官方工具，支持数据库设计、SQL 开发。

    https://dev.mysql.com/downloads/workbench/

  • Sequel Ace：轻量级开源客户端。

    https://sequel-ace.com/

    ---

    通过以上步骤，您可以在 macOS 上快速部署 MySQL 服务。建议优先使用 Homebrew 安装以简化后续更新和维护。