WSL2下VS Code远程容器中DISPLAY重定向问题求助

我之前碰到过几乎一模一样的问题，用PyCharm+Docker配VcXsrv好好的，换到VSCode远程容器就卡壳了，折腾了好一阵才搞定，给你分享几个亲测有效的方案：

方案一：VcXsrv + 正确配置devcontainer.json #

这个方案延续你PyCharm的经验，核心是把VcXsrv的访问权限、WSL2的DISPLAY变量和容器配置打通：

1. 正确启动VcXsrv
   启动VcXsrv时，一定要在「Extra settings」步骤勾选Disable access control（关闭访问控制），其他选项默认即可。这一步是关键，不然WSL2和容器会被X服务器拒绝访问。

2. 在WSL2中动态设置DISPLAY变量
   WSL2每次重启IP可能变化，别直接写死IP，在WSL2的终端配置文件（比如~/.bashrc或~/.zshrc）中添加以下内容：

   # 自动获取Windows主机IP并设置DISPLAY
   export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0
   # 禁用OpenGL间接渲染，避免显示异常
   export LIBGL_ALWAYS_INDIRECT=0
   

   执行source ~/.bashrc（或对应配置文件）让设置生效，或者重启WSL2终端。

3. 配置devcontainer.json
   不用写死IP，直接继承WSL2环境中的DISPLAY变量，同时挂载X11的socket：

   {
     "name": "你的开发容器",
     "build": { "dockerfile": "Dockerfile" },
     "runArgs": [
       "-v", "/tmp/.X11-unix:/tmp/.X11-unix",
       "-e", "DISPLAY=${localEnv:DISPLAY}"
     ],
     "containerEnv": {
       "DISPLAY": "${localEnv:DISPLAY}"
     },
     "remoteUser": "vscode"
   }
   

4. 容器内安装必要依赖
   在Dockerfile中添加图形相关依赖，不然OpenCV/Matplotlib会因为缺少库无法显示：

   RUN apt-get update && apt-get install -y --no-install-recommends \
       libx11-6 \
       libgl1-mesa-glx \
       libgtk-3-0 \
       python3-tk \
       && rm -rf /var/lib/apt/lists/*
   

方案二：用MobaxTerm的X服务器简化配置 #

如果你习惯用MobaxTerm启动WSL2，它自带的X服务器可以让配置更简单：

1. 用MobaxTerm启动WSL2
   打开MobaxTerm，左侧选择WSL2的发行版启动，此时MobaxTerm的X服务器会自动在WSL2环境中配置好DISPLAY变量（默认是:0.0）。

2. 配置devcontainer.json
   只需要挂载X11 socket并设置DISPLAY为:0.0即可：

   {
     "runArgs": [
       "-v", "/tmp/.X11-unix:/tmp/.X11-unix",
       "-e", "DISPLAY=:0.0"
     ]
   }
   

   同样要确保容器内安装了方案一中提到的图形依赖。

常见坑排查 #

• 防火墙拦截VcXsrv：如果配置后还是不行，暂时允许VcXsrv通过Windows防火墙（私有网络即可）。
• Matplotlib后端问题：有时候Matplotlib默认后端不支持显示，可在代码开头手动设置：

  import matplotlib
  matplotlib.use('TkAgg')  # 或Qt5Agg
  import matplotlib.pyplot as plt
  

• 容器用户权限：如果用非root用户（比如默认的vscode用户），确保用户能访问/tmp/.X11-unix下的socket，开了Disable access control的话一般不会有问题。

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