PyCharm Community 2021.2配置远程Python Docker解释器问题咨询

前置准备 #

先获取运行容器内部的Python解释器绝对路径，在本地终端执行命令：
docker exec <运行中容器ID/容器名> which python3
将命令返回的路径（例如/usr/local/bin/python3.10）复制备用。

配置步骤 #

• 打开PyCharm顶部菜单栏 文件 > 设置 > 项目: [你的项目名称] > Python解释器
• 点击解释器选择栏右侧的齿轮图标，选择「添加」选项
• 在弹出的添加解释器窗口左侧列表，选中「Docker」选项
• 右侧「服务器」下拉栏选中你已经验证连接成功的Unix socket Docker服务
• 「镜像名称」下拉栏选中运行中容器对应的镜像，若存在多个标签，选择和你启动容器时一致的镜像标签
• 点击窗口右下角的「下一步」，等待PyCharm完成初始镜像扫描
• 扫描完成后点击「上一步」回到之前的配置页，原本灰色不可编辑的「Python解释器路径」输入框会变为可编辑状态，直接粘贴你提前获取的容器内Python路径即可
• 确认信息无误后点击「完成」，等待PyCharm同步容器内的依赖库信息，配置即可生效

常见问题排查 #

• 如果扫描后回到上一步仍无法编辑路径，可重启PyCharm后重新执行上述流程
• 若你使用Docker Compose部署容器，添加解释器时选择左侧的「Docker Compose」选项，后续配置逻辑和上述流程一致
• 确认操作全程目标容器处于运行状态，镜像架构和本地设备架构匹配

内容的提问来源于stack exchange，提问作者ammar naich