PS D:\PythonProject> pip install dnspython WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='pypi.org', port=443): Read timed out. (read timeout=15)",)': /simple/dnspython/ WARNING: Retrying (Retry(total=3, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError("HTTPSConnectionPool(host='pypi.org', port=443): Read timed out. (read timeout=15)",)': /simple/dnspython/ WARNING: Retrying (Retry(total=2, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ProtocolError('Connection aborted.', ConnectionResetError(10054, '远程主机强迫关闭了 , None, 10054, None))': /simple/dnspython/

### 解决 Windows 系统上 pip 安装 dnspython 时遇到的 SyntaxError 和 ReadTimeoutError 问题 在 Windows 系统中使用 `pip` 安装第三方库（如 `dnspython`）时，可能会因环境配置不当或网络连接不稳定而触发 `SyntaxError` 或 `ReadTimeoutError`。以下是对此现象的原因分析以及对应的解决方案。 --- #### 1. **SyntaxError 的根本原因** 当用户试图在 Python 的交互式 Shell 中直接输入 `pip install dnspython` 时，Python 将其视为一条非法语句而不是有效的命令，因此会抛出 `SyntaxError`[^3]。这是因为 `pip` 实际上是一个独立于 Python Shell 的命令行工具。 --- #### 2. **解决 SyntaxError 的方法** ##### 方法一：切换至系统命令提示符 为了正确执行 `pip` 命令，应退出 Python Shell 并转而在系统的命令提示符（Command Prompt）下运行以下命令： ```cmd pip install dnspython ``` ##### 方法二：升级 pip 版本 有时旧版的 `pip` 可能存在兼容性问题，建议先更新到最新版本再尝试安装： ```cmd python -m pip install --upgrade pip ``` 随后再次运行 `pip install dnspython` 来完成安装。 ##### 方法三：通过 Python 脚本调用 pip 如果无法离开当前的 Python Shell 环境，则可以通过如下方式间接调用 `pip`： ```python import subprocess subprocess.check_call([r"C:\Path\To\Your\Python.exe", "-m", "pip", "install", "dnspython"]) ``` 注意替换路径为实际的 Python 可执行文件位置。 --- #### 3. **ReadTimeoutError 的根本原因** 在网络条件较差或者 PyPI 仓库响应缓慢的情况下，`pip` 在等待远程资源超时时会产生 `ReadTimeoutError`[^4]。这通常发生在下载大型包或访问速度较慢的镜像源时。 --- #### 4. **解决 ReadTimeoutError 的方法** ##### 方法一：增加超时时间 可以显式设置更大的超时参数来延长等待期限： ```cmd pip install --default-timeout=100 dnspython ``` ##### 方法二：更换国内镜像源 由于国际网络延迟较高，推荐改用国内的 PyPI 镜像站点加速下载过程。例如阿里云、清华大学 TUNA 镜像站等均提供稳定的服务。下面是以清华为例的配置方式： 一次性更改： ```cmd pip install dnspython -i https://pypi.tuna.tsinghua.edu.cn/simple ``` 永久生效（编辑或创建 `%APPDATA%\pip\pip.ini` 文件并加入以下内容）： ```ini [global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple timeout = 100 ``` ##### 方法三：离线安装 若持续面临严重的网络障碍，可以选择手动获取 `.whl` 文件后进行本地安装。前往 [Unofficial Windows Binaries for Python Extension Packages](https://www.lfd.uci.edu/~gohlke/pythonlibs/#dnspython)，挑选适合 Python 3.6.x 架构的预编译轮子下载下来，接着执行： ```cmd pip install path_to_downloaded_file.whl ``` --- #### 5. **验证安装结果** 无论采取何种措施解决问题之后都应当检验是否成功导入该模块： ```python import dns.resolver print(dns.__version__) ``` 无报错即表明已顺利装载所需功能。 --- ###