MySQL 官方已停止对旧版安装包（如 MySQL 5.7 Windows ZIP Archive）的默认支持，且从 8.0.19 开始，
mysqld --initialize不再自动生成随机 root 密码——这意味着手动安装极易卡在初始化或登录环节。直接下载 MSI 安装器虽简单，但会强制写注册表、后台服务、修改 PATH，不适合开发多版本共存或容器化场景。
Windows 下免安装 ZIP 包启动失败：找不到 my.ini
或报错 Can't find messagefile
这是 ZIP 包最常卡住的第一步。MySQL 8.0+ 不再自带
my.ini，也不再从当前目录自动加载配置；它默认只查
C:my.ini或
C:my.cnf，若不存在，就用内置硬编码参数启动，而这些参数不兼容多数本地环境（比如默认
secure_file_priv为空导致 LOAD DATA 失败）。 必须手动创建
my.ini，放在 MySQL 解压根目录（如
D:mysql-8.0.33-winx64my.ini），内容至少包含：
[mysqld] basedir=D:\mysql-8.0.33-winx64 datadir=D:\mysql-8.0.33-winx64\data port=3306 character-set-server=utf8mb4
basedir和
datadir路径中的反斜杠必须双写（
\），单斜杠会被误解析为转义符 首次初始化前，确保
datadir目录为空，且 MySQL 进程对该目录有完全读写权限（右键 → 属性 → 安全 → 编辑 → 添加当前用户并勾选“完全控制”）
Linux 手动编译安装后 mysql
命令提示 command not found
源码编译（
cmake && make && make install）默认安装到
/usr/local/mysql，但不会自动更新 shell 的命令搜索路径。PATH 未包含
bin/子目录，所以
mysql、
mysqld都不可见。 临时生效：运行
export PATH=/usr/local/mysql/bin:$PATH永久生效：把上面这行加到
~/.bashrc（普通用户）或
/etc/profile（系统级），然后执行
source ~/.bashrc验证是否生效：运行
which mysql，应输出
/usr/local/mysql/bin/mysql别漏掉
ldconfig：如果后续连接时报
libmysqlclient.so.21: cannot open shared object file，需将
/usr/local/mysql/lib加入
/etc/ld.so.conf.d/mysql.conf，再运行
ldconfig
初始化时 mysqld --initialize
报错 Failed to find valid data directory
这个错误不是因为数据目录不存在，而是 MySQL 在初始化阶段会尝试用
datadir中已有的 ibdata1、ib_logfile* 等文件做校验。如果该目录之前被其他 MySQL 实例用过，或残留了不兼容版本的文件（比如 5.7 的日志文件用于 8.0 初始化），就会直接退出。 最稳妥做法：删掉整个
datadir目录，重新
mkdir一个空文件夹 不要用
mysqld --initialize-insecure图省事——它生成无密码 root，但 MySQL 8.0.29+ 已弃用该选项，新版会静默忽略并仍走安全初始化流程 初始化成功后，密码会写在错误日志里（不是终端输出），位置由
log-error配置项决定；若没设，就在
datadir下的
hostname.err文件中，用
grep 'temporary password' hostname.err查
手动安装真正的难点不在步骤多，而在于每一步的隐式依赖都藏在文档角落：Windows 的路径转义、Linux 的动态库缓存、初始化对空目录的洁癖……哪怕只漏掉
ldconfig或少写一个反斜杠，都会让后续所有操作变成黑盒调试。
