根本原因是应用未监听文件变化，挂载仅使文件可见而非自动热重载：node.js需nodemon，flask需--debug --reload，静态文件可立即生效，但js模块或go/rust需手动构建。
为什么 docker run -v 挂载后修改文件不生效？
常见现象是：宿主机改了代码，容器里 node server.js 或 python app.py 却没反应，日志没刷新，甚至重启进程也读不到新内容。根本原因不是同步失败，而是应用本身没监听文件变化——挂载只是让文件系统可见，不等于自动热重载。
- Node.js 项目需额外装
nodemon，启动命令改成nodemon index.js，而非直接node index.js - Python Flask 默认不启用 debug 模式，必须加
--debug --reload参数，例如flask run --host=0.0.0.0:5000 --debug --reload - 静态文件（如 HTML/CSS）通常能立即生效，但 JS 模块或编译型语言（Go、Rust）需手动触发构建，挂载本身不替代构建步骤
devcontainer.json 里 mounts 和 volumes 用哪个？
优先用 volumes 字段（即 "volumes": ["/host/path:/container/path"]），而不是 mounts。前者由 Docker 守护进程原生管理，兼容性好、性能稳定；后者是 VSCode 自定义的低层挂载方式，仅在特定镜像或 Windows WSL2 下偶发路径解析错误。
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
-
volumes支持相对路径写法，如"./src:/workspace/src"，VSCode 会自动解析为绝对路径 -
mounts中的${localWorkspaceFolder}变量在某些远程 SSH 场景下会为空，导致挂载失败且无明确报错 - 如果必须用
mounts（例如需要consistency: cached优化 macOS 文件监听），务必确认容器内/proc/mounts确实存在对应条目，否则同步静默失效
Mac / Windows 上同步延迟高，inotify 不触发怎么办？
本质是宿主机文件系统事件无法穿透到 Linux 容器内。Docker Desktop 在 macOS/Windows 上通过 gRPC-FUSE 层转发 inotify 事件，但默认配置较保守，尤其对大量小文件（如 node_modules）易丢事件。
- macOS：在 Docker Desktop → Preferences → Resources → File Sharing 中，确保项目目录已加入共享列表，且勾选 “Use the new Virtualization Framework”
- Windows：启用 WSL2 后，在
%USERPROFILE%\AppData\Local\Docker\wsl\data所在磁盘需开启“Windows Defender 实时保护排除项”，否则扫描会阻塞 inotify - 通用缓解：在容器内安装
inotify-tools并运行inotifywait -m -e modify,create,delete /workspace测试事件是否到达；若无输出，说明底层事件丢失，只能降级为轮询（如 nodemon 的-L参数）
多容器场景下，如何让数据库变更实时反映到应用容器？
数据库文件（如 SQLite 的 .db 文件）不能靠挂载同步——多个进程同时写同一文件会损坏数据。正确做法是只挂载应用代码，数据库走网络连接。
- 用
docker-compose.yml定义db和app两个 service，app容器通过服务名（如http://db:5432）访问数据库，而非挂载.db文件 - 若必须共享结构化数据（如配置 JSON），挂载只读卷：
volumes: ["./config:/app/config:ro"]，避免应用容器意外写入 - 开发时想快速重置数据库？用
docker-compose exec db psql -U user -c "DROP DATABASE xxx; CREATE DATABASE xxx;"，别依赖文件同步
