Ubuntu 20.04 LTS下VS Code启动无界面控件但功能可用求助

问题详情 #

• 系统环境：Ubuntu 20.04 LTS
• 异常表现：VS Code启动后仅显示彩色背景，无标题栏控制按钮、侧边栏、状态栏等界面元素，但核心功能正常（可点击对应位置创建文件、编辑内容）
• 触发场景：突发出现，关闭窗口后再次启动即出现此问题
• 界面截图：

可行解决方案 #

以下是针对此类UI渲染异常的排查和修复步骤，按顺序尝试：

1. 重置窗口状态 #

关闭所有VS Code进程，在终端执行命令重置窗口布局：

code --reset-window-state

执行完成后重新启动VS Code。

2. 排除扩展冲突 #

扩展兼容性问题可能导致UI渲染失败，启动VS Code时禁用所有扩展：

code --disable-extensions

若启动后界面恢复正常，说明是某款扩展引发的问题，可逐个启用扩展并重启排查。

3. 清理缓存文件 #

删除VS Code的缓存目录，解决缓存损坏导致的渲染异常：

rm -rf ~/.config/Code/Cache
rm -rf ~/.config/Code/CachedData

删除完成后重启VS Code。

4. 更新/重装VS Code #

版本bug也可能引发此类问题，先尝试更新至最新版本：

sudo apt update && sudo apt install --only-upgrade code

若更新无效，卸载后重新安装：

sudo apt remove --purge code
sudo apt autoremove
# 添加官方源并重新安装
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
rm -f packages.microsoft.gpg
sudo apt update && sudo apt install code

5. 检查图形驱动 #

VS Code依赖GPU加速渲染，确保显卡驱动为最新版本：

• NVIDIA显卡用户执行：

sudo ubuntu-drivers autoinstall

重启系统后再次启动VS Code测试。

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