使用 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）