Sublime Text窗口透明度由系统控制,非编辑器功能:Windows用SetLayeredWindowAttributes、Linux依赖XComposite、macOS基本不可行;推荐使用Transparency插件(非SublimeTextTrans),支持Ctrl+Shift+[1–6]六档预设及自定义Alpha值(整数数组),数值170为实用下限。

Sublime Text 窗口透明度不是编辑器功能,而是系统级控制
你调不了“背景透明”,只能调整个窗口的系统 Alpha 值(0–255)。改 color_scheme 或往 .sublime-theme 里硬塞 layer0.opacity,只影响侧边栏、标签页这些 Sublime 自己画的区域,标题栏、窗口边框、任务栏缩略图全都不透——这不是 bug,是设计限制。
真正生效的,只有操作系统对窗口图层的不透明度设置:Windows 调用 SetLayeredWindowAttributes,Linux 依赖 XComposite,macOS 则基本不可行(SIP 封锁严格,WindowTint 等工具常闪退或拒绝权限)。
-
255= 完全不透明(默认) -
200≈ 78% 不透明(推荐起始值,文字清晰) -
170是实用下限;再低,深色主题下括号高亮、行号、光标容易糊成一片 - 低于
150基本失去可用性,连菜单都看不清
装 Transparency 插件,别碰 SublimeTextTrans
目前唯一稳定适配 Sublime Text 4 的方案是 Transparency(作者 treaclyor),不是早已停更的 SublimeTextTrans。两者共存会冲突,安装前务必删掉 SublimeTextTrans 文件夹(路径:Preferences → Browse Packages…)。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索并安装Transparency - 若提示
There are no packages available for installation,说明 Package Control 通道加载失败(国内常见),需手动在Preferences → Package Settings → Package Control → Settings – User中添加:{"channels": ["https://packagecontrol.io/channel_v3.json"]},保存后重启 Sublime - 安装完立即生效:菜单栏出现
View → Window's Transparency,快捷键Ctrl+Shift+[1–6]对应 6 档预设值
自定义快捷键对应的具体 Alpha 值
默认 Ctrl+Shift+1 是 255,Ctrl+Shift+6 是 170,但你可以改成任意整数序列。比如想让 Ctrl+Shift+3 对应 205(≈80% 不透明),就改用户配置:
打开 Preferences → Settings – User,添加或修改:
{"levels": [255, 240, 205, 190, 175, 160]}
- 数组长度必须为 6,顺序严格对应
Ctrl+Shift+1到Ctrl+Shift+6 - 数值只能是整数,不能写
"205"或205.0,否则插件静默失效 - 改完保存即生效,不用重启,下次按快捷键就用新值
- 如果快捷键失灵,先检查是否和
Emmet、SideBarEnhancements等插件的 keymap 冲突
Windows/Linux 进阶:用脚本替代插件做精细控制
插件只给固定档位;如果你需要开机自动设值、绑定全局快捷键、或多显示器动态响应,系统级脚本更可靠。
Windows 推荐 AutoHotkey,核心指令是:WinSet, Transparent, N, A(N 是 0–255 的 Alpha 值,A 表示当前活动窗口)。
- 脚本中加判断:
If InStr(active_title, "Sublime Text"),避免误设其他程序 - 注意:Windows 若开启了「淡入淡出菜单」等动画效果,
WinSet可能失效,需在「系统属性 > 高级 > 性能设置」中关闭所有视觉效果 - Linux 下推荐
Picom配置窗口规则,比桌面环境原生规则更稳定,尤其适配 ST4 的窗口类名
macOS 用户请直接放弃这条路——不是没工具,是系统根本不让你动 Sublime 的窗口层级,折腾半天大概率白忙活。










