VSCode原生不支持窗口透明，需系统级补丁实现；workbench.colorCustomizations仅影响内部UI元素，无法控制窗口边框、标题栏等；Windows推荐vscode-transparency补丁，macOS/Linux受限于系统限制，远程开发场景下补丁无效。
VSCode 原生不支持窗口背景透明，所谓“透明背景”实际是通过系统级补丁（如 Windows 的 vscode-transparency 或第三方 Electron 透明补丁）劫持渲染层实现的，不是设置项开关——直接改 settings.json 里的 workbench.colorCustomizations 只能调编辑器内容区（如侧边栏、编辑区）的 alpha，对窗口边框、标题栏、任务栏预览图毫无影响。
为什么改 workbench.colorCustomizations 没用
这个配置只作用于 VSCode 内部 Webview 渲染的 UI 元素，比如 editor.background、sideBar.background。它不能穿透 Electron 容器，更无法控制窗口本身的 opacity 或 DWM 层级。你看到的“半透明效果”其实是靠系统把整个 VSCode 窗口设为分层窗口（Layered Window），再由补丁动态注入透明度值。
-
editor.background设成#00000000只会让代码编辑区变透明，底下若没开系统级透明，依然显示默认灰白底 - 标题栏、滚动条、弹出菜单（如 Ctrl+P）永远不受该配置影响
- 某些主题（如 One Dark Pro）会主动覆盖
sideBar.background，导致你写的透明色被忽略
Windows 下必须用 vscode-transparency 补丁
这是目前最稳定、更新及时的补丁方案，原理是替换 VSCode 自带的 resources/app/out/vs/code/electron-sandbox/worker/workerMain.js 并注入 DWM API 调用。它不依赖修改注册表或全局钩子，重启 VSCode 即生效。
- 下载对应 VSCode 版本的补丁包（注意：VSCode 1.86+ 需用 v1.12+ 补丁，旧版补丁会报错
Cannot find module 'vs/base/common/platform'） - 补丁安装后，配置写在
%APPDATA%\Code\User\settings.json里，关键字段是："transparency.opacity"（0.7–0.95 较稳妥）、"transparency.blur"（仅 Windows 10/11 支持，设"acrylic"或"mica"） - 禁用硬件加速（
"disable-hardware-acceleration"启动参数）可避免模糊失效或闪烁，但会略微增加 CPU 占用
macOS 和 Linux 的现实限制
macOS 上 Electron 官方禁用了 setVibrancy 对非原生窗口的支持，所有声称“Mac 透明”的插件（如 vscode-transparent）本质只是把 workbench.colorCustomizations 里所有 background 设为带 alpha 的色值，且无法处理 Dock 预览、Mission Control 缩略图等系统级视图——它们永远是不透明的矩形块。
- Linux（X11）需手动启用
compton或picom并配置opacity-rule，但 VSCode 窗口类名不稳定（有时是Code，有时是code），规则容易失效 - Wayland 下几乎无解：GNOME/KDE 默认禁用客户端透明请求，强行开启会导致 Alt+Tab 卡顿、截图异常
- 所有平台下，远程开发（SSH/WSL）场景中透明补丁均不可用，因为补丁运行在本地 Electron 进程，而渲染实际发生在远端
真正起效的透明永远发生在窗口系统层，而不是 CSS 或主题配置里。补丁一旦失效（比如 VSCode 自动更新后），别急着重装，先检查 resources/app/out/ 下文件哈希是否被重置——这才是最常被忽略的故障点。
