Windows 下让 VSCode 窗口真正透明只能靠 vscode-transparency 补丁,它通过替换 Electron 渲染入口并调用 DWM API 实现 Acrylic/Mica 模糊与 alpha 通道;需匹配 VSCode 1.86+ 与补丁 v1.12+,配置 "transparency.opacity" 和 "transparency.blur" 到 %APPDATA%\Code\User\settings.json,启用 --disable-gpu 启动参数,并设 "window.titleBarStyle": "custom"。

Windows 下怎么让 VSCode 窗口真正变透明?
VSCode 原生不支持窗口级透明,Windows 上唯一稳定生效的是 vscode-transparency 补丁,不是插件——它替换 Electron 渲染入口并调用 DWM API,才能启用 Acrylic/Mica 模糊+alpha 通道。
常见错误现象包括:装了插件没反应、设了 "transparency.opacity": 0.8 却仍是实心窗口、模糊一闪而过就变黑。
- 必须匹配版本:
VSCode 1.86+需用补丁v1.12+,否则启动报错Cannot find module 'vs/base/common/platform' - 配置写在用户级
%APPDATA%\Code\User\settings.json中,不是工作区设置 - 必须加启动参数
--disable-gpu,否则模糊失效或严重闪烁 -
"window.titleBarStyle": "custom"是硬性前提,设成"native"会直接关闭透明通道
macOS 上 GlassIt-VSC 和 Vibrancy Continued 有什么区别?
两者都调系统 API,但作用层和约束完全不同:GlassIt-VSC 控制窗口整体 alpha 值(纯透明),Vibrancy Continued 调用 NSVisualEffectView 实现毛玻璃(vibrancy),不是透明度滑块能控制的“模糊强度”。
容易踩的坑是混用或权限缺失。比如 Vibrancy 在浅色主题下静默降级为灰白底,GlassIt 在 Rosetta 模式下拖动卡顿。
- GlassIt-VSC 不改任何 CSS 或配置,只调
NSWindow.setAlphaValue_();快捷键需手动写进keybindings.json,如{"key": "cmd+shift+up", "command": "glassit.increase"} - Vibrancy Continued 必须在「系统设置 → 隐私与安全性 → 辅助功能」里手动添加 VSCode.app 并解锁,否则连请求都发不出去
- 两者都不影响
terminal.integrated.background或sideBar.background,这些仍要单独配#RRGGBBAA - 禁用
"window.nativeTabs": false可缓解 Mission Control 缩略图不模糊的问题
workbench.colorCustomizations 能不能实现窗口透明?
不能。它只改编辑器内部 Webview 渲染层的颜色,永远穿不透 Electron 容器——标题栏、边框、Dock 预览、右键菜单、命令面板(Ctrl+P)全不受影响。
你看到的“半透明效果”,只是编辑区、侧边栏、终端这些 UI 区域各自叠了一层带 alpha 的背景色,和窗口是否透明无关。
-
editor.background推荐用"#1e1e1e1a"(10% 透明),浅色主题可放宽到"#ffffff26"(15%) -
terminal.integrated.background必须显式写,"transparent"或rgba()全被忽略,只认#RRGGBBAA - 某些主题(如 One Dark Pro)会覆盖你的
editor.background,测试时建议先切回Default Dark+ -
backgroundCover.opacity是另一套逻辑,和workbench.colorCustomizations完全无关,混用易视觉割裂
为什么终端设了 #00000000 还是黑的?
因为终端透明依赖底层合成通道是否打开,不是颜色值写了就生效。Windows/macOS 触发条件完全不同,且多数失败是配置链断裂导致的静默 fallback。
典型表现:编辑器区域已半透,终端却像一块墨镜盖在上面;或者 macOS 下设了 #00000000 却只看到毛玻璃,不是预期的桌面壁纸。
- Windows 必须同时满足:
window.titleBarStyle: "custom"+ 未加--disable-gpu+ Windows 10 2004+/Win11 - macOS 终端“透明”本质是 vibrancy,仅深色主题 + Ventura/Sonoma 生效;Monterey 及更早版本大概率抽风
-
terminal.integrated.background和terminal.background是两个键,后者已弃用,别写错 - 终端字体在低透明度下边缘易发虚,建议搭配
"terminal.integrated.fontSize": 13和"terminal.integrated.fontWeight": "normal"


















