VS Code执行Rebuild and Reopen in Container（Docker远程容器）失败如何解决

错误根因 #

1. 手动部署的code-server与VS Code Remote Containers功能不兼容：Remote Containers依赖的是和你本地VS Code版本严格匹配的官方内置Server组件，你安装的第三方开源code-server是独立产品，无法被Remote Containers调用，因此部署后无法解决问题。
2. Dockerfile存在语法笔误：你配置sudo权限的最后一行参数写为$USERNAM，缺少末尾的E，会导致用户权限配置失败，属于隐性问题。
3. TLS证书错误的核心原因是容器内部请求下载VS Code Server时SSL校验失败，通常是基础镜像缺少根证书包、内网环境使用自签名HTTPS代理导致的。

解决步骤 #

第一步：修正Dockerfile问题 #

在原有Dockerfile基础上补充根证书安装、修正笔误，修改后参考：

FROM opt_image:latest
ARG USERNAME=abc
ARG USER_UID=444
ARG USER_GID=$USER_UID
RUN groupadd --gid $USER_GID $USERNAME \
&& useradd --uid $USER_UID --gid $USER_GID -m $USERNAME \
&& apt-get update \
# 补充安装根证书包，解决基础镜像证书缺失问题
&& apt-get install -y ca-certificates sudo \
&& echo $USERNAME ALL=\(root\) NOPASSWD:ALL > /etc/sudoers.d/$USERNAME \
# 修正原来的变量名笔误
&& chmod 0440 /etc/sudoers.d/$USERNAME
USER ${USERNAME}

如果是内网自签名代理环境，将你的内网根证书文件（例如internal.crt）放到Dockerfile同目录，在上述RUN步骤前添加证书导入逻辑：

COPY internal.crt /usr/local/share/ca-certificates/internal.crt
RUN update-ca-certificates

第二步：绕开容器内部下载限制（推荐内网用户使用） #

直接配置VS Code本地下载Server和扩展后再推送到容器，完全避免容器内网络请求的证书问题：
打开本地VS Code的设置页面，添加配置：

"remote.downloadExtensionsLocally": true

配置完成后重启VS Code，重新执行Remote-Containers: Rebuild and Reopen in container即可。

可选：清理无效配置 #

你当前devcontainer.json的build.args中定义的VARIANT、NODE_VERSION参数在自定义Dockerfile中并未使用，可直接删除，避免冗余配置。

内容的提问来源于stack exchange，提问作者Rtop