VSCode 里设置背景“透明度”，可不是一两个选项就能搞定的——所有 UI 区域是分层独立的：编辑区、侧边栏、终端、状态栏各有各的配置项，而且必须用 #rrggbbaa 这样的八位十六进制来指定 Alpha 值。至于 rgba() 写法，在 1.86 及更高版本里大概率会被静默忽略，试都别试。
当然，实际操作时还有几个坑需要留意。先说最核心的：
workbench.colorCustomizations 里怎么设 editor.background 才生效
这个配置只影响你写代码的那个内容区域，标题栏、命令面板、文件缩略图统统不碰。它生效的前提是格式和覆盖策略都得对：
editor.background必须用八位十六进制，比如"#1e1e1e80"，其中后两位80对应大约 50% 不透明。你如果写"rgba(30,30,30,0.5)"，VSCode 1.86+ 可能会直接把它扔掉，不报错也不生效。- 像 One Dark Pro、Dracula 这类主流主题，会在自己的
package.json里声明一套workbench.colorCustomizations，启动时就把你写的值覆盖掉了。这是个容易被忽略的“暗坑”。 - 验证起来很简单：临时切换到 VSCode 自带的
Default Dark+主题，如果透明效果出来了，那就是主题的问题。确认生效后，再换回你喜欢的主题，必要时在settings.json末尾加一行备注，提醒自己“此处配置可能被主题覆盖”。
sideBar.background 和 panel.background 为什么没跟着变透明
VSCode 的 UI 是分层绘制的，各区域互不依赖。你会发现编辑区透了，但侧边栏还是实心黑块——这不是你漏配了什么，而是根本没配对应区域。必须显式写出每一个要调整的部分：
- 需要配置的常用区域包括：
sideBar.background（侧边栏）、panel.background（输出面板、调试控制台等）、statusBar.background（状态栏）、activityBar.background（活动栏）。 - 推荐按梯度设置透明度：编辑区稍实一点（比如
"#00000020"），侧边栏可以更透（"#00000015"），状态栏甚至可以直接全透（"#00000000"）。这样既能看清内容，又不会让界面显得压迫。 - 如果你还用了 Background Cover 这类插件来加壁纸，
panel.background设置不能太不透明。比如"#00000010"就可能盖住底图，建议不超过"#00000008"。
terminal.integrated.backgroundOpacity 怎么和 editor.background 配合
终端背景和编辑器背景是完全解耦的。前者用专用配置项 terminal.integrated.backgroundOpacity，后者走 workbench.colorCustomizations。如果混着乱调，很容易出现文字发虚或背景错位的问题：
terminal.integrated.backgroundOpacity是一个浮点数（0.0–1.0），比如 0.85。它是在terminal.integrated.background设置的纯色底上叠加的透明度，不是直接改背景色。- 所以正确的做法是：先把
terminal.integrated.background设成一个深灰色，比如"#0d0d0d"，再叠上backgroundOpacity。如果底是纯黑，再加上低 opacity，文字边缘就会透出编辑器背景，看起来像是长了“毛边”。 - 如果你同时用了 Background Cover，终端不单独调
backgroundOpacity，你就会发现代码底下那张桌面壁纸“穿”上来，干扰阅读。 - 最后，别把
terminal.integrated.backgroundOpacity设到 0.7 以下，尤其在暗色主题里，很容易导致光标和文字的对比度彻底崩坏。
为什么装了插件还是不透明？三个最常被忽略的点
如果配置都写对了但就是不生效，那问题多半出在底层环境：
- Windows 用户注意：
window.titleBarStyle必须设成"custom"。如果是"native"，整个透明通道会被直接关掉。 - macOS 用户：像 GlassIt-VSC 这类插件需要你在系统「隐私与安全性 → 辅助功能」里手动勾选 VSCode，否则它无权调用窗口 API 来调整透明度。
- 所有平台通用：如果你启用了
electron.launchArgs（比如加过--disable-gpu），某些插件（如 Background Cover）的 DOM 注入可能会被拦截。这时候要么关掉 launchArgs，要么换用 vscode-transparency 这类补丁方案。
