### 配置 PyCharm 调试连接到本地 Docker 容器 #### 设置Docker环境 为了使PyCharm能够与本地Docker容器交互，需先确认已安装Docker，并能正常运行。确保Docker服务处于开启状态，在命令行输入`docker ps`应显示当前正在运行的容器列表。 #### 创建或选择已有Docker镜像 创建一个新的Dockerfile来定义开发环境所需组件，或者选用现有的官方Python镜像作为基础[^1]。对于后者，可以通过如下指令拉取最新版Python镜像： ```bash docker pull python:latest ``` #### 启动带有SSH服务的Docker容器 为了让PyCharm顺利连接至容器内部执行调试操作，建议启动时映射必要的端口并启用SSH服务。例如，下面这条命令会基于指定镜像启动一个新容器，并将主机上的2222端口映射给容器内的默认SSH端口(即22)，同时赋予容器名称以便管理: ```bash docker run -d -p 2222:22 --name my_python_container python:latest /usr/sbin/sshd -D ``` 这里假设所使用的Python镜像已经预装了OpenSSH Server；如果没有，则可能需要额外配置步骤以安装该软件包[^3]。 #### 在PyCharm中添加Remote Interpreter via Docker Compose (如果适用) 打开项目设置窗口(`File -> Settings`)，导航到`Project Interpretor`选项卡下的`Add...`按钮旁边的小齿轮图标菜单中的`More...`项。点击左侧栏底部的加号"+"，然后选择`Docker`方式添加解释器。按照向导提示完成后续配置过程，包括但不限于选择目标平台架构(x86_64 或 arm64)以及具体要关联的目标容器等信息。 #### 使用PyCharm进行远程调试准备 回到IDE界面内，通过右键单击想要调试的应用程序入口文件(.py结尾),从弹出菜单里挑选`Debug '...'`选项触发一次完整的编译构建流程。此时应该能看到控制台输出有关于监听地址的信息，通常形式类似于`Listening at tcp://0.0.0.0:<some_port>`。记录下这个端口号用于下一步骤配置[^2]。 #### 构建Run Configuration实现断点调试功能 进入`Run->Edit Configurations...`,新建一项名为`Python Remote Debug`的任务类型。在此处填入之前获取到的服务IP地址（如果是同一网络环境下的话通常是localhost），还有对应的debug port数值。保存更改后即可利用此配置来进行常规意义上的设断点、步进等功能测试啦！ ---