# macOS 安装

URL: https://caijiao.org/mariadb/intro/install/macos
Source: docs/mariadb/intro/install/macos.md
Description: 本节介绍如何在 macOS 上安装 MariaDB，包括使用 Homebrew 与官方安装包两种方式，帮助你快速完成数据库环境搭建与启动配置。

在 macOS 系统中安装 MariaDB 的方式有多种，其中以 Homebrew 安装最为便捷，同时也可以使用官方提供的安装包。以下将介绍两种主流方式：

## 方法一：使用 Homebrew 安装（推荐）

### 1. 安装 Homebrew（若尚未安装）

在终端执行以下命令：

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

安装完成后，确保已设置好 `brew` 命令的环境变量。

### 2. 安装 MariaDB

执行：

```bash
brew install mariadb
```

安装完成后，启动 MariaDB 服务：

```bash
brew services start mariadb
```

### 3. 连接数据库

在终端中输入：

```bash
mysql -u root
```

即可连接至 MariaDB 数据库。

### 4. 设置 root 密码（可选）

首次使用时可为 root 用户设置密码：

```sql
ALTER USER 'root'@'localhost' IDENTIFIED BY 'your_password';
```

## 方法二：使用官方安装包

前往 MariaDB 官网下载 macOS 安装包：

👉 [https://mariadb.org/download](https://mariadb.org/download)

下载 `.pkg` 文件后双击安装，按照引导完成。

安装完成后，MariaDB 可作为系统服务运行，相关命令与 MySQL 类似，通常位于 `/usr/local/mysql/bin`。

## 安装验证

无论使用哪种方式，安装成功后均可执行：

```bash
mysql -u root
```

若成功进入 MariaDB 命令行，即表示安装完成。