sublime text 本身不支持原生背景透明度,所谓“透明”实为系统级窗口透明(windows/linux 可控,macos 因sip限制基本不可靠);正确方案是安装transparency插件,通过系统api调节0–255级透明度,推荐起始值设为200(≈78%不透明),避免低于175影响可读性。

Sublime Text 本身不支持背景透明度,所谓“背景透明”其实是系统级窗口透明(Windows/Linux 可控,macOS 基本不可靠),Windowism 插件并不存在——你可能记混了名字,实际应为 Transparency 插件。
为什么改 color_scheme 里的 background_opacity 没用?
这个字段只影响编辑区文字底色的 Alpha 混合,和窗口无关。它不会让标题栏、侧边栏、标签页、任务栏缩略图变透明,甚至不影响窗口边框。你调的不是 Sublime 的渲染层,而是配色方案里一个局部样式值;设成 0.1 后只会看到一片灰白或黑底,但窗口本身依然完全不透明。
- 常见错误现象:改完
background_opacity发现“没变化”,或侧边栏突然变白、主题加载失败 - 真正起作用的是操作系统对整个窗口图层的 Alpha 控制(0–255 整数),Sublime 自身无此 API 暴露
- 该字段在深色主题下还可能削弱括号高亮、行号对比度,导致阅读吃力
怎么正确安装和使用 Transparency 插件?
这是目前唯一适配 Sublime Text 4、免编译、不 patch 二进制、通过系统 API 动态调节窗口透明度的稳定方案。别装 SublimeTextTrans——它最后更新是 2018 年,ST4 下大概率报错或失效,且与 Transparency 冲突。
- 先卸载残留:
Preferences → Browse Packages…,删掉SublimeTextTrans文件夹 - 按
Ctrl+Shift+P输入Package Control: Install Package,搜Transparency安装(注意拼写,不是SublimeTextTrans) - 若提示
There are no packages available for installation,说明 channel 失效:打开Preferences → Package Settings → Package Control → Settings – User,加一行:{"channels": ["https://packagecontrol.io/channel_v3.json"]},保存后重启 - 安装后菜单栏出现
View → Window's Transparency,快捷键Ctrl+Shift+[1–6]对应 6 档预设值(默认从255到170)
如何自定义快捷键对应的透明度数值?
打开 Preferences → Package Settings → Transparency → Settings – User,写入 {"levels": [255, 240, 225, 205, 190, 175]}。数组从左到右严格对应 Ctrl+Shift+1 到 Ctrl+Shift+6,数值越小越透明。
- 推荐起始值设为
200(≈78% 不透明),兼顾通透感与可读性 - 低于
175后,在深色主题 + 高亮度显示器下,光标、行号、括号匹配高亮易辨识困难 - Windows 用户注意:若系统开启了「淡入淡出菜单」等动画效果,
Transparency可能失效;需进「系统属性 → 高级 → 性能设置」关掉所有视觉效果 - 修改后无需重启,保存即生效
macOS 用户为什么基本不用试?
系统 SIP 机制严格限制第三方工具注入窗口层级,WindowTint 等工具对 Sublime 支持极不稳定,新版 macOS 常直接拒绝调用,强行启用可能触发权限拦截甚至闪退。所谓「透明」在 macOS 上只是视觉错觉——靠调度中心(F3 或四指上滑)临时查看底图更可靠;真要提升可读性,反而建议在「系统设置 → 辅助功能 → 显示」中开启「降低透明度」。
真正容易被忽略的一点:你调的从来不是 Sublime 的“背景”,而是整个窗口的系统图层。标题栏、边框、任务栏缩略图全都不受控制——这不是美化,是系统行为的有限借用。











