✅ 1. 下载地址
官方下载地址:
👉 https://sourceforge.net/projects/vcxsrv/
点击绿色的 “Download” 按钮,下载 vcxsrv-64.X.X.X.installer.exe
安装包。
✅ 2. 安装步骤
-
双击安装包启动安装
-
全程默认即可,一路点击 Next
-
安装目录默认:
C:\Program Files\VcXsrv
-
勾选 Create Desktop Shortcut(可选)
-
安装完成后,点击 “Finish”
🚀 二、配置 VcXsrv 启动项
✅ 使用 XLaunch
配置(图形向导)
安装完后,在开始菜单搜索 XLaunch 并运行它,按如下步骤配置:
第一步:选择显示方式
-
选项:
Multiple windows
(多窗口) -
✅ 保持默认,点击 Next
第二步:选择显示模式
-
勾选 ✅
Start no client
-
点击 Next
第三步:Extra settings
保持如下设置:
-
勾选 ✅
Disable access control
(关闭访问控制,允许外部连接) -
✅ 其余默认即可
点击 Next
第四步:保存配置(可选)
可以勾选 “Save configuration”,保存为 .xlaunch
文件(方便下次双击启动)
点击 Finish 启动 X Server
🔧 三、Windows 防火墙配置
首次运行 VcXsrv 时,Windows 可能弹出防火墙提示:
“Windows 防火墙阻止了此应用的一些功能”
请务必点击:
✅ 允许 VcXsrv 通信(勾选私有和公有网络)
🧠 四、WSL 或远程 Linux 端配置(用于图形程序显示)
如果你用的是 WSL(Windows Subsystem for Linux),在 WSL 终端中执行:
bash
复制编辑
export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0
或者直接:
bash
复制编辑
export DISPLAY=localhost:0
可写入 ~/.bashrc
或 ~/.zshrc
里,方便自动设置。
✅ 五、测试图形程序
确保 X Server 已启动(即 VcXsrv 正在运行),然后在 WSL 中运行一个图形程序试试:
bash
复制编辑
xclock # 时钟 xeyes # 跟随鼠标的眼睛 gedit # 图形文本编辑器(需安装)
如果弹出窗口说明配置成功!
📌 常见问题排查
问题 | 原因 | 解决办法 |
---|---|---|
没有窗口弹出 | DISPLAY 未正确设置 | 检查 echo $DISPLAY 输出 |
程序报错 “Can't open display” | 没连上 X Server | 检查 VcXsrv 是否已运行 |
黑屏卡顿 | 防火墙阻挡 | 检查 Windows 防火墙是否允许 VcXsrv |
中文乱码 | 没装字体 | 安装 fonts-wqy-zenhei 或 fonts-noto-cjk |
如你是在 WSL2 中使用,还可以额外设置:
bash
复制编辑
export LIBGL_ALWAYS_INDIRECT=1
防止 OpenGL 图形程序崩溃。