VSCode容器启动参数核心是devcontainer.json的4个必配字段：image或dockerFile（二选一）、runArgs（Docker原生命令行数组）、workspaceFolder（容器内路径需与挂载一致）、forwardPorts（端口数组，EXPOSE无效）。
VSCode 在容器内配置启动参数，核心是通过 devcontainer.json 控制容器运行时行为，而不是在宿主机上给 VSCode 本身传参。你真正要配的，是容器怎么起、用什么用户、挂什么卷、开哪些端口——这些才是影响开发体验的关键参数。
devcontainer.json 中必须设对的 4 个关键字段
很多人以为改 Dockerfile 就够了，其实 VSCode 启动容器时根本不会读 Dockerfile 的 CMD 或 ENTRYPOINT；它只认 devcontainer.json 里明确定义的字段：
-
"image"或"dockerFile"：二选一，指定基础镜像或构建路径；混用会报错 -
"runArgs"：数组格式，填 Docker CLI 原生命令行参数，比如["--privileged", "--cap-add=SYS_PTRACE"]；注意不能写成字符串"--privileged --cap-add=SYS_PTRACE" -
"workspaceFolder"：容器内工作区路径（如"/workspaces/my-project"），必须与挂载卷实际路径一致，否则打开文件会提示“文件不存在” -
"forwardPorts"：数组，如[3000, 5432]，决定哪些端口自动从容器暴露到宿主机；不写就不会自动转发，即使 Dockerfile 里有 EXPOSE 也没用
为什么 postCreateCommand 不等于启动参数
"postCreateCommand" 是容器创建后、VSCode Server 启动前执行的命令，常被误当成“容器启动参数”。但它不影响容器生命周期，只影响初始化环境：
- 它在
root用户下运行（除非你显式加"runAsRoot": false） - 它不接受交互式输入，
npm init -y可以，npm init会卡住 - 它无法改变容器的 UID/GID，想切用户得靠
"runArgs": ["-u", "1001:1001"]或 Dockerfile 里的 USER 指令 - 如果命令失败（如
yarn install报错），整个容器附加会中断，VSCode 提示 “Failed to attach to container”
调试代理和语言服务的启动参数藏在哪
VSCode 2026 默认启用容器内调试代理，但它的行为由两个隐藏参数控制，不写进 devcontainer.json 就不生效：
-
"debug.enableContainerDebugging": true（必须在customizations.vscode.settings下）——关掉它，断点就永远灰掉 -
"debug.containerRuntime": "docker"（同上位置）——Kubernetes 场景要改成"kubernetes"，否则代理连不上 socket - Go 调试需额外编译参数：
-gcflags="all=-N -l"，这不是容器参数，而是构建命令的一部分，得写在postCreateCommand或 Makefile 里 - Node.js 要求 ≥18.17.0，低于这个版本即使配对了调试参数，V8 inspector 也不会自动发现
Windows 用户最容易漏掉的路径权限问题
在 Windows 上用 WSL2 + Docker Desktop 时，devcontainer.json 里的路径看似没问题，但实际挂载会失败：
- 不要用
C:\my-project这种 Windows 绝对路径，Docker 会把它当 Linux 路径处理，结果挂载为空目录 - 正确做法是把项目放在 WSL2 文件系统里（如
/home/user/my-project），然后在devcontainer.json中写"workspaceFolder": "/workspaces/my-project" - 如果非要用 Windows 路径，必须启用 Docker Desktop 的 “Use the WSL2 based engine”，并在设置里勾选对应发行版，否则
runArgs里的-v映射直接静默失效 - WSL2 默认禁用 inotify，导致文件变更监听失灵；需在
/etc/wsl.conf加[automount] options = "metadata"并重启 WSL
真正难调的从来不是参数本身，而是参数生效的上下文——runArgs 改了没效果？先看 docker ps -a 里容器是不是真用了你写的参数；forwardPorts 不通？去容器里 ss -tlnp 确认服务是否监听在 0.0.0.0 而不是 127.0.0.1。
