sublime text窗口透明度依赖系统api而非编辑器原生支持,windows/linux可通过setlayeredwindowattributes或xcomposite实现,macos因sip限制基本不可行;推荐使用transparency插件(非已废弃的sublimetexttrans),通过快捷键或自定义levels数组调节0–255级透明度,建议最低值不低于170以保障可读性。

Sublime 窗口透明度不是编辑器功能,是系统 API 调用
Sublime Text 本身完全不支持原生窗口透明背景——所谓“透明”,其实是 Windows 或 Linux 通过 SetLayeredWindowAttributes(Windows)或 XComposite(X11)对整个窗口图层设置 Alpha 值。macOS 基本不可行,SIP 限制严,WindowTint 等工具对 Sublime 支持极不稳定,常一升级就失效。
这意味着:改 color_scheme 里的 background_image、硬 patch .sublime-theme 加 layer0.opacity,都只是在 UI 元素上叠图或调色,不影响标题栏、边框、任务栏缩略图,也不是真透明;这类操作还容易导致主题加载失败、界面变白。
- 真正生效的只有系统级透明度控制:数值范围
0–255,255= 完全不透明,0= 完全透明(不可用,光标/菜单消失) - 低于
170后,在深色主题 + 高亮度显示器下,括号匹配高亮、行号、光标极易辨识困难 - Sublime Text 4 下,
SublimeTextTrans已多年未维护,大概率报错或静默失效;必须用Transparency(作者 treaclyor)
怎么装 Transparecy 插件并让它真正生效
安装失败是高频问题,核心原因往往是 Package Control 的 channel 加载失败(尤其国内网络),不是插件本身有问题。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索并安装Transparency(注意拼写,不是SublimeTextTrans) - 如果提示
There are no packages available for installation:打开Preferences → Package Settings → Package Control → Settings – User,添加:{ "channels": ["https://packagecontrol.io/channel_v3.json"] },保存后重启 Sublime 再试 - 安装成功后,删掉旧插件残留:
Preferences → Browse Packages…→ 找到并删除SublimeTextTrans文件夹(如果存在) - 重启 Sublime,菜单栏应出现
View → Window's Transparency,快捷键Ctrl+Shift+[1–6]可即刻切换
怎么自定义快捷键对应的具体透明值
默认 Ctrl+Shift+1 到 6 对应的是固定档位(如 255, 235, 215, 195, 180, 170),但你可以精细调节,比如把第 4 档设为 205,第 6 档卡在 170 避免可读性崩坏。
- 打开
Preferences → Settings – User - 添加或修改
"levels"数组,例如:"levels": [255, 240, 225, 205, 185, 170]
-
"levels"是整数数组,不能写小数或字符串;修改后无需重启,保存即生效(下次按快捷键时就用新值) - 数值越小越透明,但建议第 6 档不低于
170,否则在 Mariana / Monokai 等深色主题下,光标和语法高亮会“融进背景”
别踩 macOS 和“伪透明”的坑
macOS 用户请直接放弃折腾窗口透明——不是插件不行,是系统不允许。Apple 对窗口层级控制极严,第三方工具常被 SIP 拦截,即使临时生效,一次系统更新或安全补丁就回退。网上教你在系统设置里开“降低透明度”来“提升对比度”,那是在削弱 macOS 自身的毛玻璃效果,和 Sublime 无关。
还有人想用背景图 + 低 background_opacity 模拟透明感,这只能作用于编辑区文字区域,对侧边栏、标签页、状态栏、标题栏全部无效;且 background_image 必须是绝对路径,跨设备同步配置时极易断链。
真正轻量又兼容的做法是视觉弱化:关掉边框("overlay_scroll_bars": "disabled")、调低行间距("line_padding_top"/"line_padding_bottom" 设为 2)、用 Adaptive.sublime-theme 配合浅灰底色方案——比强求透明更稳,也更少出问题。










