序言

本教程由「小荣的网络开发日志」实操整理编写，实操踩坑验证，内容真实可靠。

遇到操作问题可直接联系作者，转载需标注原文出处，禁止私自篡改商用。

承接网站、APP、小程序、各类脚本定制开发；

AI 编程教学、一对一项目全程陪跑，提供免费技术咨询。

联系方式：微信：rongyaolg 电话：18375295913

这篇适合谁

如果你准备做网站后台、管理系统、登录注册、订单、文章、课程、CRM 这类项目，优先学 MySQL。它是新手最常见、资料最多、AI 也最容易帮你排错的关系型数据库。

MySQL 是干嘛的

MySQL 负责把数据长期保存下来。比如用户表、订单表、文章表、课程表，都可以放在 MySQL 里。

你可以把它理解成一个更严格的 Excel：

概念	新手理解
database	一个项目的数据仓库
table	一张表，比如 users、orders
row	一条数据
column	一个字段，比如 name、phone
password	管理数据库的密码，不是网站用户密码

安装前先做决定

新手只需要记住：

个人学习：安装 MySQL Community Server
可视化管理：安装 TablePlus、DBeaver 或 MySQL Workbench 任意一个
端口：默认 3306
root 密码：一定要记下来

不建议一开始装太多数据库。先把 MySQL 装好、连上、会建库建表，就够大多数入门项目用了。

Windows 安装步骤

打开 MySQL 官网，下载 MySQL Installer for Windows
选择 Developer Default 或 Server only
一路 Next，遇到密码设置时给 root 设置一个你记得住的密码
端口保持默认 3306
安装完成后打开 PowerShell，测试命令：

mysql --version

如果提示找不到 mysql，说明环境变量没有配好。你可以先用 MySQL Workbench 或 TablePlus 连接，不影响学习。

macOS 安装步骤

如果你已经安装 Homebrew，推荐用命令安装：

brew install mysql
brew services start mysql
mysql --version

第一次进入 MySQL：

mysql -u root

如果你希望给 root 设置密码，可以执行：

ALTER USER 'root'@'localhost' IDENTIFIED BY '你的密码';
FLUSH PRIVILEGES;

用可视化工具连接

装好 MySQL 以后，建议再装一个数据库可视化工具。

可视化工具可以理解成“数据库管理界面”：不用每次都敲命令，也能看到数据库、数据表和里面的数据。对刚开始学的小白来说，会直观很多。

推荐优先使用免费的工具：

工具	是否免费	适合谁
DBeaver Community	免费开源	Windows / macOS 都能用，推荐优先选择
MySQL Workbench	免费	MySQL 官方工具，适合只管理 MySQL
HeidiSQL	免费	Windows 用户可以用，轻量简单

如果你不知道选哪个，直接用 DBeaver Community 就可以。

新建 MySQL 连接时，一般填写这些内容：

字段	填什么
Host	`localhost` 或 `127.0.0.1`
Port	`3306`
User	`root`
Password	安装 MySQL 时设置的密码
Database	可以先不填

连接成功后，可以新建一个数据库：

CREATE DATABASE ai_teach_demo DEFAULT CHARACTER SET utf8mb4;

如果工具提示连接失败，优先检查这几件事：MySQL 服务有没有启动、密码有没有写错、端口是不是 3306。

给项目连接 MySQL

常见 Node.js / Prisma 项目的连接地址长这样：

DATABASE_URL="mysql://root:你的密码@localhost:3306/ai_teach_demo"

字段含义：

片段	含义
`root`	数据库用户名
`你的密码`	MySQL 密码
`localhost`	连接本机数据库
`3306`	MySQL 默认端口
`ai_teach_demo`	数据库名称

常见问题

端口 3306 被占用

说明电脑里可能已经有一个 MySQL。不要重复安装，先确认服务状态：

mysql --version

Windows 也可以打开“服务”，搜索 MySQL。

忘记 root 密码

学习阶段最快的处理方式通常是卸载重装，并删除旧的数据目录。正式项目不要这样做，正式项目要先备份数据。

AI 生成的连接地址连不上

让 AI 检查这四件事：

数据库服务是否启动
端口是不是 3306
用户名密码是否正确
数据库名是否真的存在

学完你应该做到

知道 MySQL 适合什么项目
本机能启动 MySQL
能用可视化工具连接
能创建数据库
能看懂项目里的 DATABASE_URL

MySQL 安装教程：Windows / macOS 从下载到连接

序言