如何在PyCharm中配置带nodemon的Docker Compose Python运行/调试配置

能否在PyCharm中搭建基于Docker Compose的Python运行/调试配置，使用nodemon启动脚本实现热重载？目前通过docker compose up启动项目时nodemon可正常工作，但按照官方指南配置的Docker Compose远程解释器运行/调试配置，虽能正常断点调试，却缺少热重载功能。

已配置的Dockerfile内容如下：

FROM python:3.8

WORKDIR /app
COPY requirements.txt /app/
RUN pip install -r requirements.txt


# Install Node.js and npm
RUN apt-get update && apt-get upgrade -y && \
    apt-get install -y nodejs \
    npm                       

# Install nodemon globally
RUN npm install -g nodemon

RUN groupadd -g 999 python && \
    useradd -r -u 999 -g python python

RUN chown python:python /app

COPY --chown=python:python . .

USER 999
ENV PYTHONUNBUFFERED=TRUE

RUN chmod +x src/queue_consumer.py

CMD ["nodemon", "--exec", "python", "src/queue_consumer.py"]

PyCharm当前使用的是基于Docker Compose的远程解释器运行/调试配置。

方法一：修改现有Docker Compose配置，直接调用nodemon #

1. 打开PyCharm的运行/调试配置，选中已有的Docker Compose配置项
2. 切换到命令标签页，覆盖容器默认的启动命令：
   • 在输入框中填写：nodemon --exec python src/queue_consumer.py
   • 若nodemon全局安装路径不在容器PATH中，可通过docker exec <容器名称> which nodemon获取绝对路径，替换为/usr/local/bin/nodemon --exec python src/queue_consumer.py
3. 保存配置后运行，代码修改后nodemon会自动触发重载

方法二：分离运行与调试配置（兼顾热重载与断点调试） #

上述方法虽能实现热重载，但可能影响调试稳定性。建议拆分配置：

1. 保留原有的Docker Compose调试配置，用于需要断点调试的场景
2. 新建一个Docker Compose运行配置：
   • 选择对应的docker-compose.yml文件和目标服务
   • 在命令中指定nodemon启动命令，无需配置调试相关参数
   • 日常开发用该配置运行实现热重载，需要调试时切换回原配置

替代方案：使用Python原生工具实现热重载（无需nodemon） #

若不想依赖Node.js生态，可使用watchdog库实现Python代码热重载：

1. 在requirements.txt中添加依赖：watchdog
2. 创建启动脚本run.py：

from watchdog.observers import Observer
from watchdog.events import FileSystemEventHandler
import subprocess
import sys

class ReloadHandler(FileSystemEventHandler):
    def __init__(self):
        self.restart_process()

    def restart_process(self):
        if hasattr(self, 'process'):
            self.process.kill()
        self.process = subprocess.Popen([sys.executable, "src/queue_consumer.py"])

    def on_modified(self, event):
        if not event.is_directory and event.src_path.endswith(".py"):
            self.restart_process()

if __name__ == "__main__":
    event_handler = ReloadHandler()
    observer = Observer()
    observer.schedule(event_handler, path="src", recursive=True)
    observer.start()
    try:
        while True:
            pass
    except KeyboardInterrupt:
        observer.stop()
    observer.join()

3. 修改Dockerfile的CMD为["python", "run.py"]，或在PyCharm配置中直接调用该脚本

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