笑晕！Python连MySQL居然这么简单，新手再也不用被报错逼疯[特殊字符]

南汁bbj

569人浏览 · 2026-04-22 21:14:55

南汁bbj · 2026-04-22 21:14:55 发布

笑晕！Python连MySQL居然这么简单，新手再也不用被报错逼疯🤯

作为一名常年和Python、MySQL打交道的码农，我太懂新手的痛了：

明明跟着教程一步步敲代码，结果要么报“找不到模块”，要么连不上数据库，甚至还有人把“MySQL”看成“明月三千里”，慕名去吃了顿烤肉，回来发现代码还是没跑通😂（程序员的崩溃真的很突然）。

其实啊，Python和MySQL的连接，根本不是什么高深技术，就像“牛郎织女鹊桥相会”——只要找对“鹊桥”（连接库），再把“约会密码”（参数）输对，俩神仙就能顺畅唠嗑，全程10分钟搞定，新手也能零报错通关！

今天就用最接地气的话，带大家吃透Python与MySQL的连接，没有晦涩概念，全是能直接复制粘贴的干货，看完点赞收藏，下次连库再也不用翻半天教程～

一、先搞懂：为啥要让Python和MySQL凑一对？

很多新手会问：我用Python能处理数据，用MySQL能存数据，为啥要把它们连起来？

举个通俗的例子：Python就像一个“数据处理大神”，能做计算、做分析、做自动化；MySQL就像一个“超级文件柜”，能把海量数据整整齐齐存起来，还能快速查找。

俩东西单独用都很能打，但凑一起就是“王炸”——比如你用Python爬了10万条数据，总不能存在Excel里吧？存到MySQL里，后续查询、修改、复用都贼方便；再比如你要做一个简单的网站，用Python写后端逻辑，用MySQL存用户信息，完美配合✅

据统计，约75%的Python应用程序都需要和数据库进行数据交换，尤其是Web开发、数据分析、自动化脚本这些场景，俩兄弟缺一不可。

二、前期准备：3步搞定“鹊桥”和“约会资格”

要让Python和MySQL成功“牵手”，得先做好准备工作，就像约会前要收拾打扮、确认时间地点一样，一步都不能少，而且全程零难度！

1. 安装“鹊桥”：连接库（新手首选pymysql）

Python和MySQL本身不互通，得靠一个“中间人”——连接库。主流的有3种，但新手直接冲pymysql 就对了！

它是纯Python实现的，不用额外编译，兼容性还好，安装起来就一行命令，复制粘贴到终端/CMD里，回车就行：

# 普通安装
pip install pymysql
# 国内镜像加速（推荐，避免下载太慢）
pip install pymysql -i https://pypi.tuna.tsinghua.edu.cn/simple

这里插一句：千万别手滑拼错单词！我见过有人把pymysql写成“pymyql”，装了半天没装上，急得直挠头，别犯这种低级错误哦😂

2. 确认MySQL“在线”：别白跑一趟

就像约会前要确认对方到没到，连接前得先确认MySQL服务已经启动了，不然Python再努力，也连不上“空房间”。

不同系统启动命令不一样，直接抄作业：

# Windows系统（CMD以管理员身份运行）
net start mysql
# Linux系统
sudo service mysql status  # 查看状态，没启动就用sudo service mysql start

如果启动失败，大概率是MySQL没装对，或者端口被占用，新手先别慌，重启电脑试试，基本能解决80%的问题。

3. 准备“约会密码”：MySQL账号密码

连接MySQL需要3个核心信息，少一个都不行，记好：

主机地址（host）：本地连接就是 localhost 或 127\.0\.0\.1，远程连接填服务器IP；
用户名（user）：默认是 root（相当于MySQL的“超级管理员”）；
密码（password）：安装MySQL时你自己设的密码，别忘啦！

额外提醒：如果是新手，建议先创建一个测试数据库，避免操作失误删了重要数据，创建命令放这了，直接在MySQL终端执行：

-- 创建测试数据库
CREATE DATABASE python_test;
-- 切换到测试数据库
USE python_test;
-- 创建测试表（后续操作能用得上）
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(100) UNIQUE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

三、核心操作：Python连MySQL，全程复制粘贴就行

准备工作做好，接下来就是最关键的一步——写代码连接，这部分我直接给“万能模板”，新手不用懂原理，复制过去，改3个地方（账号、密码、数据库名），就能直接运行！

模板1：基础连接（新手必看，零报错）

# 导入连接库
import pymysql
from pymysql.err import OperationalError, ProgrammingError

# 1. 配置连接参数（就改这3个地方！）
config = {
    "host": "localhost",  # 本地连接填这个，远程填服务器IP
    "user": "root",       # 用户名，默认root
    "password": "123456", # 你的MySQL密码，替换成自己的
    "database": "python_test",  # 刚才创建的测试数据库
    "charset": "utf8mb4", # 字符集，支持emoji，避免乱码
    "port": 3306          # MySQL默认端口，不用改
}

try:
    # 2. 建立连接（相当于“鹊桥接通”）
    conn = pymysql.connect(**config)
    print("✅ Python连MySQL成功！终于牵手啦～")
    
    # 3. 创建游标（相当于“传话筒”，用来执行SQL命令）
    cursor = conn.cursor()
    
except OperationalError as e:
    # 连接失败的常见原因：密码错、MySQL没启动、端口错
    print(f"❌ 连接失败！原因：{e}")
except ProgrammingError as e:
    # 数据库不存在的情况
    print(f"❌ 数据库不存在！原因：{e}")
except Exception as e:
    # 其他未知错误
    print(f"❌ 突发错误：{e}")
finally:
    # 4. 关闭连接（重要！用完一定要关，避免浪费资源）
    if "conn" in locals() and conn.open:
        conn.close()
        print("🔌 连接已关闭，下次再约～")

解释一下：这个模板里，try-except是“避坑神器”，能捕获大部分连接错误，新手再也不用面对一堆红色报错手足无措了。

运行代码后，如果看到“✅ Python连MySQL成功！”，恭喜你，第一步已经搞定了，接下来就是用Python操作MySQL啦～

模板2：常用操作（增删改查，直接复用）

连接成功后，最常用的就是增删改查（CRUD），这部分也是干货，直接复制模板，改一改参数就能用，不用自己写SQL！

import pymysql

config = {
    "host": "localhost",
    "user": "root",
    "password": "123456",
    "database": "python_test",
    "charset": "utf8mb4"
}

try:
    conn = pymysql.connect(**config)
    cursor = conn.cursor()
    
    # 1. 新增数据（相当于往MySQL里存东西）
    insert_sql = "INSERT INTO users (name, email) VALUES (%s, %s)"
    # 用参数化查询，避免SQL注入（安全又省心）
    cursor.execute(insert_sql, ("张三", "zhangsan@example.com"))
    conn.commit()  # 新增/修改/删除必须提交事务，否则数据存不上！
    print("新增成功，新增行数：", cursor.rowcount)
    
    # 2. 查询数据（相当于从MySQL里拿东西）
    select_sql = "SELECT * FROM users WHERE name LIKE %s"
    cursor.execute(select_sql, ("张%",))
    # 获取所有结果
    results = cursor.fetchall()
    print("查询结果：")
    for row in results:
        print(f"ID：{row[0]}，姓名：{row[1]}，邮箱：{row[2]}")
    
    # 3. 修改数据（相当于改MySQL里的东西）
    update_sql = "UPDATE users SET email = %s WHERE name = %s"
    cursor.execute(update_sql, ("zhangsan_new@example.com", "张三"))
    conn.commit()
    print("修改成功，修改行数：", cursor.rowcount)
    
    # 4. 删除数据（谨慎使用！别删错了）
    delete_sql = "DELETE FROM users WHERE name = %s"
    cursor.execute(delete_sql, ("张三",))
    conn.commit()
    print("删除成功，删除行数：", cursor.rowcount)
    
except Exception as e:
    conn.rollback()  # 出错时回滚，避免数据混乱
    print(f"操作失败：{e}")
finally:
    if "conn" in locals() and conn.open:
        cursor.close()  # 先关游标
        conn.close()    # 再关连接
        print("连接已关闭")