### Jupyter 安装时 Pywinpty 版本要求及升级解决方案 #### 背景分析 在 Windows 操作系统中，`jupyter-server 1.13.5` 需要 `pywinpty<2` 的版本支持[^1]。然而，在实际环境中可能已经安装了更高版本的 `pywinpty`（如 `pywinpty 2.0.2`），这会导致不兼容的情况发生。 #### Pywinpty 版本要求 对于 `jupyter-server` 来说，其依赖关系明确规定需要 `pywinpty` 的版本小于 2 (`pywinpty<2`)。如果当前环境中的 `pywinpty` 是高于等于 2 的版本，则会出现依赖冲突问题[^1]。 #### 解决方案 以下是针对此问题的具体解决办法： 1. **卸载现有高版本 pywinpty** 如果当前环境中存在不符合条件的较高版本 `pywinpty`，可以先将其卸载： ```bash pip uninstall pywinpty ``` 2. **重新安装指定版本的 pywinpty** 使用 `pip` 工具来安装满足 `jupyter-server` 所需的较低版本 `pywinpty`，例如安装 `pywinpty==1.x.y` 的某个稳定版： ```bash pip install pywinpty==1.1.7 ``` 这里选择了 `1.1.7` 版本作为示例，具体可以根据实际情况调整到其他低于 2 的可用版本[^1]。 3. **创建独立虚拟环境** 创建一个新的 Python 虚拟环境有助于隔离不同项目之间的依赖差异，从而减少全局范围内的包管理混乱情况的发生。通过以下命令实现新建虚拟环境以及激活它： ```bash python -m venv my_jupyter_env source my_jupyter_env/bin/activate # Linux/MacOS 或者 .\my_jupyter_env\Scripts\activate.bat (Windows) ``` 4. **配置 Jupyter 内核至新环境** 将刚刚建立起来的新虚拟环境下设为可供 Jupyter Notebook 使用的一个单独内核选项之一。执行下面的操作完成设置过程： ```bash pip install ipykernel python -m ipykernel install --user --name=my_jupyter_env ``` 5. **验证安装成功与否** 启动 Jupyter 并切换到对应内核测试运行状态是否正常无误。 ```bash jupyter notebook ``` 以上步骤能够有效处理由于 `pywinpty` 不适配所引发的一系列错误现象[^2]。 --- ### 注意事项 有时即使尝试更新 `pip` 及相关组件也无法完全规避某些底层构建工具缺失带来的麻烦，比如当提示缺少 Rust 编译器及其配套程序 Cargo 时候就需要额外关注官方文档指导进行相应软件栈部署工作[^3]。 ---