pip install pymysql卡住是因默认源访问慢，应换豆瓣或清华镜像源；import失败多因装错Python环境；需用pymysql.install_as_MySQLdb()伪装MySQLdb；忌命名冲突文件。
直接换镜像源重装，90% 的情况是网络卡在下载环节，不是代码或环境问题。
pip install pymysql 卡住不动
现象是命令执行后光标一直闪烁、没报错也没进度，几小时都没反应。本质是 pip 默认走官方源 https://pypi.org/simple，国内访问极慢甚至超时。
- 用豆瓣源（稳定）：
pip install pymysql -i https://pypi.douban.com/simple/ --trusted-host pypi.douban.com - 用清华源（快）：
pip install pymysql -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn - 永久配置（避免每次敲）：编辑
~/.pip/pip.conf（Linux/macOS）或%APPDATA%\pip\pip.ini（Windows），写入：[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple/ trusted-host = pypi.tuna.tsinghua.edu.cn
安装成功但 import pymysql 报错 ModuleNotFoundError
这不是没装上，而是装到了“另一个 Python 环境里”。常见于多版本共存、虚拟环境未激活、IDE 解释器选错。
Ai Video Pipeline
下载
对话式AI短视频创作工具：用户提出想法，Agent生成脚本，人工确认后自动生成MP4。触发条件：①制作视频/短视频；②AI旁白视频；③认知自述/播客风格视频；④文稿转视频。仅出现“视频”“TTS”“语音”等模糊词时不激活（可能是其他需求）。
- 确认当前运行的是哪个解释器：
which python（macOS/Linux）或where python（Windows） - 在这个解释器下查是否真有 pymysql：
python -m pip list | grep pymysql - 如果没看到，说明装错了环境——比如你在系统 Python 里装了，但 PyCharm 运行的是 venv 里的 Python
- 解决办法：进对的环境再装，例如激活虚拟环境后执行
source venv/bin/activate（Linux/macOS）或venv\Scripts\activate（Windows），再跑 pip install
想用 MySQLdb 接口但只装了 pymysql
很多老项目或 Django 配置里写的是 import MySQLdb，而 pymysql 默认不响应这个模块名，会直接报错。
- pymysql 提供了伪装机制，在项目入口（如
manage.py或__init__.py）最顶部加这两行：import pymysql pymysql.install_as_MySQLdb()
- 注意顺序：必须在任何
import MySQLdb之前执行，否则无效 - 不推荐长期依赖这种伪装，生产环境建议改用
mysqlclient（需编译，但更稳）
最容易被忽略的一点：别在项目目录里建一个叫 mysql.py 或 MySQLdb.py 的文件，Python 会优先导入本地文件而非包，导致 ImportError 看似神隐。
