这个话题我打交道的时间不短了。项目标题看起来很简单，就是“MySQL安装与配置以及使用Pycharm设置MySQL连接”，但实际操作中，大多数人恰恰是卡在别人觉得“根本不用讲”的地方：版本不知道选哪个，初始化不知道跑哪条命令，好不容易启动成功，Pycharm这边又报一个莫名其妙的时区错误。这篇文章把这一整套流程拆开，从选版本、装服务、做基础配置，到Pycharm里建数据源、连库、跑查询，全部过一遍，每个步骤都讲清楚为什么要这么做。适合刚接触数据库、第一次在自己电脑上搭环境的人，也适合已经装了MySQL但一直没搞定Pycharm连接、想彻底排查一遍问题的人。

1. 版本选择和安装方式是第一个分岔口

1.1 社区版、LTS、还是“看起来很新”的版本

很多人打开MySQL官方网站，第一眼会看到一个大大的“MySQL Community Server”下载按钮，但再往下拉，就会发现版本号分了好几种：像5.7、8.0，还有8.4、9.x这些数字。第一次装的人很容易懵。我的建议非常明确：生产环境老老实实用8.0系列，个人学习、本地开发也选8.0，不要为了“图新鲜”去装9.x。

这里的逻辑其实很简单。MySQL 8.0是当前公认最稳的长期支持系列，各大框架、第三方连接库对它的适配做得最完善，你今天用的Pycharm、Python的PyMySQL、Django、Flask-SQLAlchemy，默认都是按8.0的行为测试过的。5.7虽然也曾经是经典，但它已经是上一代产品，有些默认行为跟8.0不一样，比如字符集默认值、密码认证插件，新手照着新教程操作时容易对不上。9.x是创新版，功能新但维护周期短，没必要为了尝鲜给自己埋坑。

1.2 安装包和免安装ZIP，到底选哪个

Windows平台上有两种主流安装方式：一是MSI图形安装向导，二是ZIP免安装压缩包。我几次实操下来，更推荐ZIP包，原因有四条。第一，ZIP包所有文件都在一个目录里，卸载的时候删掉目录和服务注册信息就行，干干净净，不会在系统里残留一堆注册表项。第二，MSI向导虽然界面友好，但中间每一步都会让你做选择，新手反而容易在“挑选产品”“配置服务器类型”“设置Windows服务”这些界面里走错。第三，ZIP包不依赖图形化安装逻辑，服务出错时可以直接用命令行诊断，对后续学习命令行操作也有帮助。第四，团队里如果有多台机器要装，ZIP包拷贝分发非常方便，配置一模一样。

当然，MSI也有它的价值：如果完全不想碰命令行，或者需要MySQL Installer来统一管理多个MySQL相关组件，走图形向导也完全可行。只是我更习惯“数据目录自己定，配置自己写”的掌控感。

1.3 ZIP包安装完整五步流程

我以8.0为例，实际操作步骤如下。

第一步，解压。把ZIP包解压到一个没有中文、没有空格的路径下，我习惯放在D:\mysql-8.0。注意，解压后里面是bin、include、lib、share这些文件夹，你没有看错，这个目录本身就是MySQL的安装根目录，不像普通软件还要再跑一个setup.exe。

第二步，写配置文件。在D:\mysql-8.0目录下新建一个my.ini，这是MySQL默认会去找的配置文件。第一次写的人最常犯的错是：文件内容写了中文注释，结果MySQL启动报错。建议新手的配置从最小化开始，先保证能跑起来。

[mysqld] basedir=D:/mysql-8.0 datadir=D:/mysql-8.0/data port=3306 character-set-server=utf8mb4

这里解释一下：basedir是MySQL安装路径，datadir是数据文件存放路径，port是服务监听端口，默认3306不用解释，character-set-server直接设置成utf8mb4，避免后续建表、读写中文出现乱码。很多老教程会让你单独设default-character-set和collation-server，8.0里把核心字符集设对，其他选项基本能自动关联。

第三步，初始化数据目录。以管理员身份打开命令提示符，进入MySQL的bin目录，执行：

mysqld --initialize-insecure

这条命令会按照my.ini里指定的datadir路径生成一套初始数据文件，--initialize-insecure的意思是把root初始密码设为空。如果你不加-insecure，MySQL会生成一个随机临时密码，藏在datadir目录下的错误日志里，新手还得跑去日志文件里翻密码，多此一举。本地开发环境用空密码初始化，后面自己再改，是最顺的路径。

第四步，注册Windows服务。还是管理员命令行，执行：

mysqld --install MySQL8

这条命令会创建一个名为“MySQL8”的Windows服务。这里有一个频繁踩坑的点：命令行窗口必须是以管理员身份打开的，否则会报“Install/Remove of the Service Denied”。注册成功后，服务默认是手动启动状态。如果你希望开机自启，可以用sc config MySQL8 start= auto，注意start=后面有一个空格。

第五步，启动服务并验证。执行：

net start MySQL8

看到“服务已经启动成功”之类的提示后，再执行：

mysql -uroot

因为初始化时root密码为空，所以不需要-p参数就能直接进入MySQL命令行，看到mysql>提示符就说明安装成功了。

提示：整个安装流程最容易出的问题是路径问题。路径里不要有中文、不要有空格，my.ini里的路径分隔符用正斜杠或转义后的反斜杠都可以，但两条路径必须和实际解压位置完全一致，多一个少一个字符都不行。

2. 装完之后的配置才是真正拉开差距的地方

2.1 root账号和日常开发账号分开用

很多人装完MySQL习惯性直接用root干所有事，这在本地学习还能忍，但一旦养成了这个习惯，后面会很麻烦。因为root的权限边界太大了，你可能在某个项目里不小心执行了DROP DATABASE，或者用root去跑一些自动化脚本，一旦代码有漏洞，数据库就全裸奔了。合理做法是创建一个独立的开发账号。

先给root设定一个密码。进入MySQL命令行执行：

ALTER USER 'root'@'localhost' IDENTIFIED BY '这里填你自己的密码';

然后创建日常开发账号：

CREATE USER 'dev'@'localhost' IDENTIFIED BY 'dev123456'; GRANT ALL PRIVILEGES ON *.* TO 'dev'@'localhost'; FLUSH PRIVILEGES;

这里'dev'@'localhost'表示这个账号只能从本机连接，对外不开放，这是最安全的默认策略。FLUSH PRIVILEGES的作用是让权限变更立即生效。以后在Pycharm、Python脚本里，一律用dev账号，root只保留在偶尔需要管理全局配置时使用。

2.2 远程连接和授权到底要怎么做

如果你的MySQL装在服务器或远程机器上，Pycharm从本地电脑去连，那就需要开放远程访问。MySQL默认行为是只允许localhost连接，因为bind-address默认指向127.0.0.1。改远程访问需要做两件事。

第一件事，授权账号可以远程登录。把前面创建账号时的host从localhost改成%，或者单独再创建一个远程账号：

CREATE USER 'dev_remote'@'%' IDENTIFIED BY 'dev123456'; GRANT ALL PRIVILEGES ON *.* TO 'dev_remote'@'%'; FLUSH PRIVILEGES;

第二件事，确认MySQL服务允许监听所有网卡。检查my.ini里的bind-address，如果是127.0.0.1，就要改成0.0.0.0，然后重启服务。这一步常常被忽略，很多人授权都配对了，Pycharm还是报“Can’t connect to MySQL server”，多半就是这个原因。bind-address=0.0.0.0的意思是监听所有网络接口，这样远程机器才能访问到3306端口。

2.3 时区、字符集和认证插件三个高频坑

我在给Pycharm配置连接时出过错的地方，有三个是特别典型的，提前说明一下。

第一个是时区。MySQL 8.0默认时区跟系统时区不一定一致，JDBC驱动连接时会要求设置连接时区。Pycharm里如果只填了用户名密码就点Test Connection，经常会看到The server time zone value '...' is unrecognized这种报错。解决办法是连接URL上带一个serverTimezone=Asia/Shanghai参数，或者在MySQL里执行：

SET GLOBAL time_zone = '+08:00';

第二个是字符集。建议在my.ini里明确设了character-set-server=utf8mb4之后，再给数据库也指定字符集。创建数据库时加一句：

CREATE DATABASE demo CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

这样从表结构到数据存储，中文环境基本不会出幺蛾子。

第三个是密码认证插件。MySQL 8.0默认用的是caching_sha2_password，这个比老版本的mysql_native_password更安全，但老客户端、老驱动不一定兼容。如果Pycharm或某个第三方工具连不上，报Authentication plugin 'caching_sha2_password' cannot be loaded，可以去MySQL里把账号的插件改回去：

ALTER USER 'dev'@'localhost' IDENTIFIED WITH mysql_native_password BY 'dev123456'; FLUSH PRIVILEGES;

不过这只下层兼容方案，能用新驱动的时候尽量保留默认插件。尤其是新版Pycharm自带的驱动，对caching_sha2_password的支持没问题，所以连接失败时要先判断是驱动版本老还是插件不兼容。

3. Python环境的预演：连不上数据库一切都白搭

3.1 PyMySQL和mysql-connector-python怎么选

在Pycharm里点击图形界面填表单之前，我强烈建议先用Python脚本把数据库连接“预演”一遍。这个习惯帮我省了很多排查时间，因为图形工具报错时信息量少，而Python脚本的回显往往会把真实的原因露出来。

Python连接MySQL有两个常用库。PyMySQL是纯Python实现的，安装简单，跨平台，目前最流行，大多数项目、教程都在用它。mysql-connector-python是MySQL官方提供的连接器，性能不错，但API和主流习惯略有差异。二选一的话，本地开发、学习，包括后续写点小项目，我推荐PyMySQL。原因很朴实：社区里几乎所有现成代码、框架封装都默认用PyMySQL，遇到问题搜答案也容易。

安装就一条命令：

pip install pymysql

3.2 最小可用的连接测试脚本

装好后，写一个几行的脚本验证连通性：

import pymysql conn = pymysql.connect( host='127.0.0.1', port=3306, user='dev', password='dev123456', charset='utf8mb4' ) cursor = conn.cursor() cursor.execute('SELECT VERSION()') version = cursor.fetchone() print('MySQL版本:', version) cursor.close() conn.close()

这段代码里有三个细节值得提。host写127.0.0.1还是localhost，在PyMySQL里差别不大，但在后面配置里建议统一用IP，避免本地域名解析带来的奇怪问题。charset='utf8mb4'这一步不是可选项，如果漏掉，后面读写中文时可能会出现编码异常。最后cursor.close()和conn.close()一定要执行，不然连接池会被占满。

如果这一步跑通，说明MySQL服务、账号权限、认证方式都没有问题。接下来Pycharm那边的配置，思路就完全一致了，只是把填IP、端口、用户名、密码的动作搬到图形界面上而已。

3.3 如果Python都连不上，优先查这三个点

Python连不上的时候，不要稀里糊涂改配置，先按顺序排查。

第一，MySQL服务到底有没有在跑。执行net start或者在服务管理器里看MySQL8这个服务是否处于“正在运行”状态。很多情况下是服务没启动，不是配置问题。

第二，3306端口是否真的在监听。命令行执行netstat -ano | findstr 3306，如果没有任何输出，说明mysqld根本没起来成功，去看MySQL错误日志，通常在datadir目录下有一个.err后缀的文件，里面记录启动失败的原因。第三，防火墙有没有放行3306。Windows防火墙经常默认拦截外部程序的访问，Pycharm虽然是本机连本机，但某些安全软件会拦，更不用说远程连接的时候了。放行规则很简单：防火墙高级设置里加一条入站规则，允许TCP 3306端口即可。

4. Pycharm里建立数据源：从填表单到执行第一条SQL

4.1 数据库面板在哪里，界面怎么布局

Pycharm的数据库管理能力很完整，不同版本入口不太一样。老版本在View > Tool Windows > Database可以打开数据库工具窗口，新版本里需要先在左侧或顶部找到“Database”标签，或者通过View工具窗口里找。如果你用的是专业版，它默认带数据库插件，不用额外安装。社区版相对麻烦，先确认你自己的版本类型，这个会影响整个流程走向。

打开Database面板后，窗口是一块空白区域，中间有个“+”号，点下去会弹出“Data Source”子菜单。在子菜单里选MySQL，这就是新建数据源的入口。整个图形界面相当友好，后面所有操作都围绕这个面板展开。

4.2 数据源配置项逐项填清楚

新建MySQL数据源之后，会看到一个设置表单，里面有Host、Port、User、Password、Database几项。每一都别跳。

Host填127.0.0.1，如果MySQL在远端服务器，就填服务器IP。Port填3306，这是MySQL默认端口，改了的话这里要同步。User填dev，Password填dev123456。Database可以留空，连接成功后再选择具体库，也可以先填一个已经存在的库名，测试的时候会多验证一层。

高级设置里，我一般这样配：

尤其allowPublicKeyRetrieval这个参数，很多人连不上的时候完全想不到。它的作用是允许客户端从服务器获取RSA公钥，用于密码加密传输。如果连的是用caching_sha2_password插件创建的账号，并且没有配置SSL，不把这个设为true，就会出现Public Key Retrieval is not allowed的报错。Pycharm的参数填写区可能不会直接显示这个字段，需要切到“高级”或手动编辑URL，把参数加在URL末尾。

所以完整URL长这样：

jdbc:mysql://127.0.0.1:3306?serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true

4.3 驱动下载失败是Pycharm连接的头号问题

填完表单，点“Test Connection”按钮，最常见的结果不是成功，而是卡在驱动下载那一步。Pycharm连接MySQL需要JDBC驱动，第一次使用时它会自动去仓库下载，但这个过程在国内网络环境下经常慢到令人崩溃，或者直接超时。

解决办法有两种。一种是在数据源设置界面点驱动列表，选一个已经存在的驱动版本，比如MySQL Connector/J 8.0系列，Pycharm会尝试重新下载。另一种是手动下载驱动包，然后点击驱动列表旁边的文件夹图标，选择本地jar包。驱动可以从MySQL官方或者Maven中央仓库拿，文件是jar格式，下载后放到任意目录，在Pycharm里指定即可。手动导入后下载慢的问题一次性根治。

注意：每次升级Pycharm版本后，如果数据库连接失效，优先检查驱动是否完好。版本升级可能把内置驱动路径改动，导致连接失败，重新导入本地驱动就能解决。

4.4 连接成功之后的几个常用操作

连接成功之后，Database面板里会列出当前连接下的所有数据库。展开某个库，能看到表、视图、存储过程、函数这些对象。双击表名可以查看表数据，右键表还能跳转到SQL编辑器，写查询语句。Pycharm的SQL控制台非常实用，点工具栏上的绿色播放按钮或者用快捷键Ctrl+Enter执行当前SQL，结果会直接以表格形式返回到面板下半部分，跟Navicat、DataGrip的体验基本持平。

在SQL控制台里执行下面这句，可以验证一切是否真的通了：

SHOW DATABASES;

执行结果如果列出了information_schema、mysql、performance_schema、sys以及你自己的库，比如demo，那整个链路就已经完成了。

如果想让操作再提升一步，可以试着在配置数据源时勾选“Store”密码保存方式，这样以后每次打开Pycharm都不用重新输密码。密码保存模式建议选“Remember”，方便但不推荐在公用电脑上开启。

5. 高频问题排查表与避坑经验

5.1 连接超时和端口不对的区分

Pycharm报Connection timed out和报Communications link failure是两回事。前者大概率是网络层面不通，比如防火墙没放行3306、bind-address还是127.0.0.1，或者端口写错了。后者常见于驱动版本和服务器版本不匹配。先判断服务端能不能连：在命令行里执行mysql -udev -p -h 127.0.0.1 -P 3306，如果能进，说明服务端没问题，问题在Pycharm的配置或驱动。这个时候就不要再反复点Test Connection了，回头一项一项对配置。

5.2 服务启动失败要看错误日志

net start MySQL8之后如果提示启动失败，不要反复启动，去看数据目录下的.err日志文件。这个日志文件命名形式是主机名.err，里面会写清楚启动失败的原因。常见的情况有：my.ini路径写错导致找不到数据目录、端口3306被占用、datadir目录权限不对。端口被占用时，用netstat -ano | findstr 3306找出占用进程的PID，再在任务管理器里确认是什么程序占了3306，处理掉或者改MySQL端口都可以。

5.3 中文乱码问题的根源在字符集链路

连接之后发现表里的中文是乱码，先别急着怀疑配置，按照字符集链路排查。第一，建库时候的默认字符集是不是utf8mb4，可以通过SHOW CREATE DATABASE demo;查看。第二，表本身的字符集是否一致。第三，连接参数里是否明确写了characterEncoding=utf8，Pycharm的JDBC URL里可能需要加characterEncoding=utf8。第四，MySQL服务端全局字符集配置，用SHOW VARIABLES LIKE 'character_set_server';确认。

5.4 忘记密码的最终手段

这个坑偶尔会遇到：某天发现root密码忘了，怎么都登不进去。MySQL提供了一种很朴素的绕过方式，先在服务端停掉服务，然后以跳过权限表的方式启动：

net stop MySQL8 mysqld --skip-grant-tables --shared-memory

然后另开一个命令行窗口，不带任何密码直接登录：

mysql -uroot

进入后执行：

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

修改完成后，关掉--skip-grant-tables那个进程，再启动正常服务即可。需要注意，这种方式在本地操作时要确保机器本身安全，因为跳过权限表的模式意味着没有任何访问控制。

5.5 日常使用中最推荐的配置组合

根据我个人的使用经验，一件很小的事能显著提升日常体验：给Pycharm中的数据源起一个一目了然的名字。默认情况下Pycharm会用主机名加用户名来命名数据源，比如root@localhost，如果机器上有多个环境、多个库，一眼分不清。在数据源配置页的“Name”字段改成容易识别的名字，比如“本地开发库-8.0”，管理和切换起来非常方便。

最后再分享一个小技巧。很多人设置连接时喜欢把数据库密码写在Pycharm的连接URL里，方便是真方便，但我后来慢慢改掉了这个习惯，因为项目里的配置文件一旦被分享出去，密码就等于裸奔了。更推荐的做法是交给Pycharm自带的密码保存功能，选“Remember”模式，本地加密存储。日常开发中，如果能同时做到“服务端用独立账号”“连接参数标准化”“驱动固定版本”，MySQL安装和连接配置这道关过了之后，后续写项目基本不会再碰这种环境问题。