mysql安装后mysql命令报“command not found”是因path未包含其bin目录：macos需在~/.zshrc中添加export path="/opt/homebrew/bin:$path"，windows安装时须勾选add mysql to path，linux手动解压部署需自行配置$path。
MySQL 安装后 mysql 命令报 “command not found” 怎么办
这是新手最常遇到的问题：明明下载安装了 MySQL，终端却无法识别 mysql 命令。根本原因是系统 PATH 没有包含 MySQL 的 bin 目录。
- macOS（Homebrew 安装）：默认路径是
/opt/homebrew/bin或/usr/local/bin，检查是否已加入 shell 配置（如~/.zshrc），加一行：export PATH="/opt/homebrew/bin:$PATH" - Windows（MSI 安装）：安装时务必勾选
Add MySQL to PATH；若漏选，需手动把类似C:\Program Files\MySQL\MySQL Server 8.0\bin加入系统环境变量 PATH - Linux（deb/rpm 包）：通常自动配置，但若用 tar.gz 手动解压部署，则必须手动将
bin/路径加入$PATH
初始化 root 密码失败或连不上 localhost:3306
MySQL 8.0+ 默认启用 caching_sha2_password 插件，且首次启动不生成明文密码，导致新手用空密码或旧方式登录失败。
- 安装完成后，Windows 会弹出配置向导（MySQL Installer），macOS/Linux 通常需手动运行
mysqld --initialize --console查看临时 root 密码（注意控制台输出末尾的A temporary password is generated for root@localhost: xxxxxx） - 首次登录必须用该临时密码：
mysql -u root -p，然后立刻执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_new_pass';，否则某些客户端（如 Navicat、旧版 PHP）会报Client does not support authentication protocol - 确认服务是否运行：
sudo systemctl status mysql（Linux）、brew services list（macOS）、任务管理器 → 服务中找mysqld（Windows）
中文乱码问题从建库就开始埋雷
不是等插入数据才出问题，而是创建数据库时没指定字符集，后续几乎无法彻底修复。
- 初始化配置文件（
my.cnf或my.ini）必须显式设置：[client]<br>default-character-set = utf8mb4<br><br>[mysql]<br>default-character-set = utf8mb4<br><br>[mysqld]<br>character-set-server = utf8mb4<br>collation-server = utf8mb4_unicode_ci
- 建库时别只写
CREATE DATABASE db_name;，要写全：CREATE DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -
utf8在 MySQL 里实际是utf8mb3，不支持 emoji 和部分生僻汉字；必须用utf8mb4
Docker 启动 MySQL 容器后应用连不上
本地开发常用 docker run -d -p 3306:3306，但仍有三个关键点被忽略：
- 必须加
-e MYSQL_ROOT_PASSWORD=xxx，否则容器内 MySQL 不会初始化 root 用户 - 端口映射仅解决“本机能访问”，如果应用也在另一个容器里（比如 Node.js 容器），不能连
localhost:3306，而应连 Docker 网络内的服务名，例如mysql:3306（前提是两个容器在同一个自定义网络） - MySQL 默认只允许本地 socket 连接，需确认容器内
mysqld启动参数含--bind-address=0.0.0.0，或在配置中设bind-address = 0.0.0.0
