在 Windows 上使用 poetry self add poetry-plugin-shell 安装 shell 插件时，常因依赖 ptyprocess 编译失败或网络超时而无限挂起；推荐改用 pip 分步安装底层依赖，绕过 Poetry 自身的构建机制，快速启用 poetry shell。
在 windows 上使用 `poetry self add poetry-plugin-shell` 安装 shell 插件时，常因依赖 `ptyprocess` 编译失败或网络超时而无限挂起；推荐改用 pip 分步安装底层依赖，绕过 poetry 自身的构建机制，快速启用 `poetry shell`。
poetry-plugin-shell 是一个为 Poetry 提供交互式 shell 支持的插件（如 poetry shell 命令），其底层依赖链包含 ptyprocess → pexpect → pywin32（Windows 专用）。在 Windows 环境下，ptyprocess 并不原生支持 Windows（它依赖 Unix-like 的伪终端 pty），因此 Poetry 在尝试通过 self add 全局安装时，会卡在编译或解析该包阶段——尤其当 Poetry 使用的打包工具（如 build 或 setuptools）试图从源码构建 ptyprocess，而该过程在 Windows 上无法完成且缺乏有效超时/降级策略。
✅ 正确解决方案：跳过 Poetry 的插件安装机制，直接用 pip 安装兼容依赖组合
由于 ptyprocess 在 Windows 上不可用，实际应使用其 Windows 友好替代方案：pexpect 的 Windows 兼容分支（但更稳妥的做法是——根本不需要 ptyprocess）。poetry-plugin-shell v0.6.0+ 已默认适配 Windows，仅需以下三个核心包（均纯 Python 或含预编译 wheel）：
# 推荐顺序安装（确保兼容性） pip install pywin32 pip install pexpect pip install poetry-plugin-shell
⚠️ 注意事项：
-
不要运行
poetry self add：该命令会触发 Poetry 全局环境的完整依赖解析与构建流程，在 Windows 下易因ptyprocess触发无响应； -
务必使用最新版 pip：
python -m pip install --upgrade pip，以确保能正确下载pexpect的 Windows wheel（如pexpect-4.9.0-py3-none-win_amd64.whl）； -
安装后需重启终端或运行
python -c "import win32api"验证 pywin32：部分系统需手动执行Scripts/pywin32_postinstall.py -install（位于 Poetry Python 环境的 Scripts 目录下）； - 若仍提示
ModuleNotFoundError: No module named 'ptyprocess'，说明插件版本过旧，请先卸载：pip uninstall poetry-plugin-shell pexpect，再按上述顺序重装。
✅ 验证是否成功：
poetry shell # 应正常进入已存在的虚拟环境，并显示类似 `(myproject-py3.11)` 的提示符
总结：该问题本质是跨平台依赖误判——Poetry 尝试在 Windows 上安装类 Unix 终端组件。通过显式用 pip 安装 Windows 兼容的依赖栈，既规避了构建陷阱，又保持了 poetry shell 的原有功能。后续建议优先选用 poetry plugin add poetry-plugin-shell（Poetry 1.7+ 新命令，比 self add 更健壮），但仍需确保底层依赖已就绪。
