dev container 是当前最稳的 node 开发容器方案，直接用 remote - containers 扩展 + .devcontainer/devcontainer.json，而非手动写 dockerfile；其三大关键配置必须配对：image 指定微软官方镜像、forwardports 显式声明端口、mounts 配置缓存一致性以保障文件监听生效。
Dev Container 是当前最稳的 Node 开发容器方案
直接用 Remote - Containers 扩展 + .devcontainer/devcontainer.json，而不是手动写 Dockerfile 后再 docker run。前者能自动挂载代码、复用 VSCode 扩展、支持调试断点和热重载；后者容易卡在权限、端口、文件监听失效等问题上。
devcontainer.json 里必须配对的三个关键项
很多失败源于只改了镜像却漏掉配套配置。以下三项要一起检查：
-
"image": "mcr.microsoft.com/vscode/devcontainers/node:18"—— 优先用微软官方 devcontainer 镜像，自带node、npm、git和 VSCode Server，不用自己RUN npm install -
"forwardPorts": [3000, 4000]—— 显式声明要转发的端口，否则即使EXPOSE了也看不到服务 -
"mounts": ["source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=cached"]—— macOS/Windows 必须加consistency=cached，否则nodemon或webpack watch会不触发文件变更
调试时端口不通？先查 launch.json 的 platform 和 port 是否匹配
VSCode 自动生成的 launch.json 里，"platform": "node" 必须和容器内实际运行的 Node 进程一致；"port" 必须等于容器内服务监听的端口（比如 app.listen(3000)），且不能和 forwardPorts 冲突。
常见错误：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 代码里写
app.listen(8080)，但launch.json里写"port": 3000→ 调试器连不上 - 容器里用了
0.0.0.0:3000，但launch.json没设"address": "0.0.0.0"→ 只监听localhost，外部访问失败 -
package.json的start脚本用了nodemon，但没在devcontainer.json的"postCreateCommand"里装它 → 容器启动后找不到命令
本地 node_modules 不同步？别用 COPY，用 volume 挂载
在 devcontainer.json 中禁用 COPY . /workspace 类操作，改用挂载：
"mounts": ["source=${localWorkspaceFolder}/node_modules,target=/workspace/node_modules,type=bind"]
这样能避免反复 npm install，也能让本地 IDE 的类型提示、跳转正常工作。但要注意：node_modules 里的二进制模块（如 fsevents）仍需在容器内重新 npm rebuild，否则 chokidar 监听可能失效。
真正麻烦的是跨平台 ABI 兼容性 —— macOS 上装的 node_modules 挂进 Linux 容器大概率跑不起来，这时候就得在 postCreateCommand 里执行 npm ci，而不是依赖本地目录。
