Mac 和 Windows 上 Docker Desktop 挂载需显式指定 :delegated（Mac）或 :cached（Windows），否则 inotify 事件无法穿透，导致 Webpack、Vite 等热更新失效；同时须确保框架配置启用 HMR、进程使用 nodemon/air 等监听工具、挂载路径与 WORKDIR 一致、权限匹配。
docker run 挂载时漏了 :delegated 标志
Mac 和 Windows 上的 Docker Desktop 默认使用 gRPC-FUSE 或 Hyper-V 文件系统桥接，inotify 事件无法穿透到容器内。Webpack、Vite、nodemon 等工具依赖这类事件监听文件变化，一旦挂载没加 :delegated，它们就收不到变更通知，热更新自然静默失效。
必须显式声明挂载模式：
-
docker run -v $(pwd):/app:delegated（Mac 推荐） -
docker run -v $(pwd):/app:cached（Windows 推荐，部分旧版 Desktop 要求） - 绝对不要写成
-v $(pwd):/app（无模式默认为consistent，性能差且事件不可靠）
注意：:delegated 不是万能开关——它只解决宿主机→容器的事件通知，不解决容器内进程是否真正响应这些事件。
Webpack 5 的 target 默认值禁用 HMR
Webpack 5 将 target: 'browserslist' 设为开发环境默认值，但这个 target 会主动剥离 HMR 运行时代码，即使你写了 hot: true，控制台也只会输出 compiled successfully，不会出现 [WDS] Hot Module Replacement enabled.。
验证和修复方法：
- 检查项目根目录是否存在
.browserslistrc或package.json中的browserslist字段 - 在
webpack.dev.js中强制覆盖：target: 'web' - 生产配置可保留
target: ['web', 'es5']，但绝不能混用到开发配置中
容器内进程没启用热加载机制
挂载只是让新文件“看得见”，不代表应用会自动重载。Node.js 项目没装 nodemon、Go 项目没用 air、Python Flask 没开 debug=True，改了代码照样不生效。
常见误区与对应动作：
- 误以为
CMD ["npm", "start"]就能热更新 → 实际应改为CMD ["npx", "nodemon", "server.js"] - Dockerfile 中
COPY . .后又挂载 → 宿主机文件覆盖镜像内容，但若进程不监听变化，仍无效 - 使用
docker-compose up时未指定command覆盖默认启动命令 → 需在docker-compose.yml的 service 下显式写command: npm run dev
权限或路径映射错位导致监听失败
某些框架（如 Vite、Next.js）会监听整个项目根目录下的 node_modules 或 src 子目录，如果挂载路径没对齐，或容器内用户 UID/GID 与宿主机不一致，fs.watch 可能静默失败。
快速排查点：
- 进容器执行
ls -l /app，确认挂载后文件属主不是root:root（尤其 Mac/Linux 开发者用非 root 用户） - 挂载路径要精确匹配进程工作目录：比如
WORKDIR /app，就必须-v $(pwd):/app，而非-v $(pwd)/src:/app/src - Node.js 项目可在启动命令前加
chown -R node:node /app &&（需基础镜像含node用户）
热更新失效往往不是单点问题，而是挂载模式、框架配置、进程启动方式、路径权限四层叠加出的“静默断链”。逐层验证比全局重配更省时间。
