使用 docker run -v 挂载宿主机目录可实现容器内代码实时同步，需配合 nodemon 等热重载工具，并注意 UID/GID 权限匹配及 macOS/Windows 文件监听限制。
使用 docker run 挂载宿主机目录，是实现容器内代码实时同步最常用、最直接的方式。关键在于正确使用 -v（或 --volume）参数，将本地开发目录映射到容器内的对应路径，并确保容器中运行的服务支持热重载（如 nodemon、webpack-dev-server、Flask debug 模式等）。
挂载语法与基本写法
标准挂载命令格式为：
docker run -v /host/path:/container/path [other options] image-name
例如，将当前目录下的 ./src 映射到容器内的 /app/src：
docker run -v $(pwd)/src:/app/src -p 3000:3000 my-node-app
注意：
- 左侧是宿主机绝对路径（推荐用 $(pwd) 或完整路径，避免相对路径歧义）
- 右侧是容器内目标路径，需与应用实际读取代码的路径一致
- 若容器内路径不存在，Docker 会自动创建（但权限可能受限，尤其在 Linux/macOS 上）
权限与文件属主问题
挂载后常见问题是容器内进程无法写入或监听文件变更，多因 UID/GID 不匹配导致：
- Linux 宿主机上，普通用户文件默认属主为
1000:1000，而某些基础镜像（如官方node）以node用户（UID 1001）运行，可能无权修改挂载文件 - 解决方法：启动时指定用户 ID，与宿主机用户一致，例如
--user $(id -u):$(id -g) - 或在 Dockerfile 中调整用户（不推荐用于开发环境，灵活性差）
- macOS 和 Windows（Docker Desktop）对文件系统事件通知支持较弱，某些热重载工具（如 chokidar）需额外配置
usePolling: true
配合热重载工具提升体验
仅挂载目录不会自动触发重启——必须依赖容器内运行的开发服务器具备文件监听能力：
- Node.js 项目可使用
nodemon：在容器中执行nodemon --watch /app/src index.js - Python Flask 可启用 debug 模式：
flask --app app.py --debug run --host=0.0.0.0:5000 - 前端项目（React/Vue）通常自带 dev server，只需确保其工作目录是挂载点，且监听开启
- 避免在 Dockerfile 中把源码
COPY进镜像——挂载会覆盖该路径，COPY成为冗余操作
进阶技巧：只读挂载与排除临时文件
出于安全或性能考虑，可限制挂载行为：
- 加
:ro设为只读：-v $(pwd)/src:/app/src:ro，适合配置文件或静态资源 - 用
.dockerignore配合构建不影响运行时挂载，但能减少镜像体积 - 若需忽略某些子目录（如
node_modules），建议在宿主机上用绑定挂载 + 单独 volume 替代，例如：-v $(pwd)/src:/app/src -v /app/src/node_modules（后者声明空 volume，屏蔽宿主机的 node_modules）
