搭建教程

本教程以 brew 为基础，默认环境已安装 brew，后续所有依赖通过 brew 来安装。

一、安装 Python 及相关依赖

安装 Python，此处以指定 Python 3.12 为例：

brew install python@3.12

二、安装数据库服务（以 MariaDB 为例）

三、迁移数据库

可能遇到的问题

1. 运行 Django 时报错 Authentication plugin 'mysql_native_password' cannot be loaded

首先，需要检查当前虚拟机环境下是否安装了 mysqlclient：

pip3 list | grep mysqlclient

确认安装了 mysqlclient 后仍然报错，则需要检查是否安装了 mysql 客户端依赖

which mysql

如果没有返回一个有效的地址，则需要安装 mysql 客户端依赖，可以通过 brew 安装。

注意！mysql 9.0 及更高版本中移除了原生鉴权插件（native authentication plugin），为了解决这个问题，需要安装 9.0 以下的版本，此处以 8.4 为例：

brew install mysql@8.4

并将该版本的安装目录链接到不含版本号的目录：

ln -s /opt/homebrew/opt/mysql@8.4 /opt/homebrew/opt/mysql

验证可解决。

参考链接：MySQL Authentication Plugin Issues on macOS - Stack Overflow