要在 Docker 容器内实现代码热重载，核心不是“让 Docker 支持热重载”，而是把三件事对齐：宿主机代码能实时进容器、容器里有监听变更并触发重载的工具、应用启动方式匹配这个机制；挂载路径必须精确覆盖应用工作区，容器内须运行 nodemon/air/uvicorn --reload 等监听命令，且开发与生产必须严格隔离。
要在 Docker 容器内实现代码热重载，核心不是“让 Docker 支持热重载”，而是把三件事对齐：宿主机代码能实时进容器、容器里有监听变更并触发重载的工具、应用启动方式匹配这个机制。Docker 本身不负责重载逻辑，它只提供挂载和运行环境。
挂载路径必须精确覆盖应用工作区
挂载不是“把代码放进去”就完事，得确保修改的文件正好落在应用实际加载的位置：
- Node.js 项目若
WORKDIR /app，就用volumes: .:/app，别只挂src/子目录 - FastAPI 或 Flask 启动入口是
app/main.py，挂载点就得对应到容器内该路径所在父目录，比如- ./app:/app - Spring Boot 开发时需挂载
target/classes和src/main/resources，否则 DevTools 看不到编译后字节码或配置变更 - PHP-FPM 项目挂载
./:/var/www/html后，还要确认php.ini中doc_root指向的是这个路径
容器内必须运行带监听能力的启动命令
光有挂载，进程不会自己反应——你得用能感知文件变化的命令替代原始运行方式：
- Node.js：用
nodemon app.js替代node app.js；TypeScript 项目推荐ts-node-dev或tsx watch - Python：FastAPI 直接加
--reload参数，如uvicorn app.main:app --reload；Flask 用flask run --reload - Go：装
air工具，启动命令写成air，并在.air.toml中指定root = "/app"（路径要和挂载点一致） - Java：Spring Boot 加
spring-boot-devtools依赖，并确保application.properties启用spring.devtools.restart.enabled=true
权限、目录与启动逻辑必须一一对应
很多热重载失败，其实是路径或权限没对上：
- 挂载前确保容器内目标目录已存在，比如
RUN mkdir -p /app，否则挂载会静默失败 - 检查
CMD或command:是否调用了监听工具，而不是原始二进制（例如别写go run main.go） - nodemon 默认忽略
node_modules和隐藏文件，要监听.env就得配nodemon.json并挂进容器 - PHP 配合
inotifywait时，脚本里kill -USR2 1要求 PHP-FPM 主进程 PID 是 1，需确认容器以php-fpm -F方式前台运行
开发与生产必须物理隔离
热重载只存在于开发阶段，不能混入生产部署：
- 在
docker-compose.yml中用profiles: ["dev"]控制挂载、command和开发工具安装，生产环境完全不加载 - 生产镜像应通过多阶段构建：构建阶段装
npm install或mvn package，最终镜像只COPY编译产物，不带源码、不装nodemon或air - 禁止在生产容器中启用
--reload、devtools或任何监听文件系统变动的机制——这是安全风险，也是性能隐患
