Sublime Text窗口透明度需通过Transparency插件调用系统API实现,macOS因SIP限制基本不可行;改background或background_opacity仅影响编辑区,与窗口整体透明无关;须卸载SublimeTextTrans、配置Package Control通道并重启、自定义levels数组(如[255,240,225,205,190,175])且关闭系统动画。

SetLayeredWindowAttributes 或 Linux 的 XComposite——macOS 因 SIP 限制基本不可行。
为什么改 background 或 background_opacity 没用?
这些字段只影响编辑区文字背景色的 Alpha 混合,和窗口整体透明度完全无关。把 "background": "#0f0f0f" 改成 "rgba(15, 15, 15, 0.8)" 后,标题栏、侧边栏、标签页、任务栏缩略图全都不透——这不是配置错,是 Sublime 根本不读这个值去控制窗口层级。
更危险的是 background_image + background_opacity:路径写错、DPI 缩放异常、GPU 渲染模式不兼容时,常出现图像拉伸、文字底色发灰,甚至整个编辑区变空白。
.sublime-theme 里硬加 layer0.opacity 或 texture?主题加载失败概率高,JSON 少个逗号就白屏,且依然不影响标题栏和窗口边框。
装 Transparency 插件前必须清理 SublimeTextTrans
两者冲突,SublimeTextTrans 已多年未维护,在 ST4.4+ 上大概率静默失效或报错 KeyError: 'window'。
- 进
Preferences → Browse Packages…,手动删掉SublimeTextTrans目录(别只禁用) - 打开
Preferences → Package Settings → Package Control → Settings – User,确保有这一行:{"channels": ["https://packagecontrol.io/channel_v3.json"]} - 保存后必须重启 Sublime,否则
Package Control: Install Package会提示There are no packages available - 重启后按
Ctrl+Shift+P输入Package Control: Install Package,搜Transparency(注意拼写,不是SublimeTextTrans)
levels 数组怎么设才不糊眼?
默认快捷键 Ctrl+Shift+[1–6] 对应整数数组 [255, 240, 225, 215, 205, 190],数值越小越透明,但不是百分比——它直接传给系统 API 做 Alpha 值。
低于 175 后,在深色主题 + 高亮度屏下,光标、括号匹配高亮、行号极易“融进背景”,尤其看久了眼睛累。
推荐自定义为:{"levels": [255, 240, 225, 205, 190, 175]}(第 6 档卡在 175 是较稳妥下限)
改完保存即生效,无需重启;若快捷键失灵,优先检查是否被 Emmet、SideBarEnhancements 等插件的 keymap 覆盖。
Windows 用户需关掉系统动画
部分显卡驱动或旧版 DWM 在启用系统动画时,会把低 Alpha 值渲染成纯黑/纯白——不是你的值写错了,是系统合成器没扛住。
设置路径:设置 → 系统 → 辅助功能 → 视觉效果 → 关闭所有“淡入淡出”类选项
这一步漏掉,哪怕 levels 设对了,也可能出现窗口突然变黑、快捷键响应延迟、甚至透明度反复跳变。


















