windows安装pymysql模块

PyMySQL是Python中连接MySQL数据库的重要模块，对于开发者来说掌握它的安装方法至关重要。本文将详细介绍在Windows系统下安装PyMySQL模块的多种方法，适合从新手到专业开发者的不同需求。

一、安装前的准备工作

在开始安装PyMySQL之前，我们需要确保系统已经满足以下基本条件：

Python环境已安装：PyMySQL是一个Python模块，自然需要Python环境支持
pIP工具可用：这是Python的包管理工具，通常随Python一起安装
网络连接正常：因为需要从Python包索引(PyPI)下载安装包

检查Python是否安装

按下Win+R键，输入cmd打开命令提示符，然后输入：

python --version

如果显示Python版本号(如Python 3.8.5)，说明已安装；如果提示"不是内部或外部命令"，则需要先安装Python。

检查pip是否可用

在同一个命令提示符窗口输入：

pip --version

正常应显示pip版本和安装路径。如果没有，可能需要重新安装pip。

二、使用pip安装PyMySQL（推荐方法）

这是最简单也是最常用的安装方法，适合大多数用户。

基本安装命令

打开命令提示符(CMD)
输入以下命令：
```
pip install pymysql
```
等待安装完成

安装特定版本

如果需要安装特定版本的PyMySQL，可以使用：

pip install pymysql==1.0.2

将"1.0.2"替换为你需要的版本号。

升级现有版本

如果已安装旧版想升级：

pip install --upgrade pymysql

三、使用源码安装PyMySQL

当pip安装出现问题或需要从源码构建时，可以采用此方法。

从PyMySQL的GitHub仓库下载源码zip包
解压到任意目录
打开命令提示符，导航到解压目录
执行：
```
python setup.py install
```

四、验证安装是否成功

安装完成后，可以通过以下方式验证：

方法1：命令行检查

在命令提示符输入：

python -c "import pymysql; print(pymysql.__version__)"

如果显示版本号，说明安装成功。

方法2：Python交互式环境测试

在命令提示符输入python进入交互环境

输入：

import pymysql
print(pymysql.__version__)

如果没有报错并显示版本号，则安装成功

五、常见安装问题及解决方案

问题1：pip安装超时

现象：安装过程中出现"ReadTimeoutError"等错误

解决方案：

使用国内镜像源，如清华源：

pip install pymysql -i https://pypi.tuna.tsinghua.edu.cn/simple

或者增加超时时间：

pip --default-timeout=100 install pymysql

问题2：权限不足

现象：出现"Permission denied"错误

解决方案：

以管理员身份运行命令提示符
或者使用--user参数：
```
pip install --user pymysql
```

问题3：与MySQL Connector冲突

现象：同时安装了PyMySQL和MySQL官方Connector可能导致冲突

解决方案：

确认项目中只使用一种连接方式
如需同时存在，确保正确导入和使用

六、PyMySQL基本使用示例

安装完成后，这里提供一个简单的连接测试代码：

import pymysql

# 创建连接
connection = pymysql.connect(
    host='localhost',  # 数据库地址
    user='root',       # 用户名
    password='123456', # 密码
    database='test',   # 数据库名
    charset='utf8mb4', # 字符集
    cursorclass=pymysql.cursors.DictCursor  # 返回字典格式数据
)

try:
    with connection.cursor() as cursor:
        # 执行SQL查询
        sql = "SELECT VERSION()"
        cursor.execute(sql)
        result = cursor.fetchone()
        print(f"Database version: {result}")
finally:
    connection.close()

七、进阶安装选项

1. 安装开发版本

如果需要最新的开发版（可能不稳定）：

pip install git+https://github.com/PyMySQL/PyMySQL.git

2. 安装可选依赖

PyMySQL有一些可选依赖，如cryptography用于更安全的密码验证：

pip install pymysql[crypto]

3. 虚拟环境安装

建议在虚拟环境中安装，避免污染全局Python环境：

python -m venv myenv      # 创建虚拟环境
myenv\Scripts\activate   # 激活虚拟环境
pip install pymysql       # 在虚拟环境中安装

八、PyMySQL与常见框架集成

1. 在Django中使用PyMySQL

在Django的settings.py中配置：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'mydatabase',
        'USER': 'root',
        'PASSWORD': '123456',
        'HOST': 'localhost',
        'PORT': '3306',
        'OPTIONS': {
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
        },
    }
}

并在__init__.py中添加：

import pymysql
pymysql.install_as_MySQLdb()

2. 在Flask中使用PyMySQL

结合Flask-SQLALchemy扩展：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql+pymysql://root:123456@localhost/mydatabase'
db = SQLAlchemy(app)