侧边栏滚动条粗细只能通过修改主题文件中 scroll_box 的 content_margin 控制,该值为四元数组,前两数越小滑块越宽;需同时禁用 overlay_scrollbar 以消除空白,并调整 layer0.tint 和 opacity 提升滑块可见性。

侧边栏滚动条粗细只能改 scroll_box 的 content_margin
Sublime Text 侧边栏(文件树)滚动条没有用户设置项,"scrollbar_size" 或 "scroll_bar_width" 这类字段写进 Settings 完全无效。它由当前主题文件中 scroll_box 规则的 content_margin 控制——这个值是四元数组,前两个数字代表左右内边距,越小,滑块视觉上越宽。
常见错误是搜“滚动条变宽”后去改 puck_control,那是编辑区右侧主滚动条用的,对侧边栏完全不起作用。
- 打开
Preferences → Browse Packages…,进入你当前启用的主题目录(如Theme - Default/或Material Theme/) - 找到并用 Sublime 打开主题文件(如
Default.sublime-theme) - 搜索
"class": "scroll_box",优先找带"attributes": ["sidebar"]或上下文含sidebar_container的 rule - 把
"content_margin": [2, 2, 2, 2]改成[1, 1, 1, 1]或[0, 0, 0, 0](不建议为 0,拖拽热区可能失效)
改完没变化?先关掉 overlay_scrollbar 占位
即使把 content_margin 设成 [0, 0, 0, 0],侧边栏右侧仍可能残留一道固定空白——这不是滑块太细,而是 overlay_scrollbar 在后台占位。它默认在 macOS 和部分 GTK 环境启用,会为“悬浮式”滚动条预留空间,哪怕你根本没开 overlay 模式。
验证是否启用:Ctrl+` 打开控制台,运行:
sublime.active_window().active_view().settings().get('overlay_scrollbar')
如果返回 "enabled" 或 True,就在用户设置中加一行:
"overlay_scrollbar": "disabled"
这个设置不是隐藏滚动条,而是关闭悬浮渲染模式,让滚动条回归传统常驻样式,空白会彻底消失。
scroll_box 和 puck_control 别混用
侧边栏滚动条走的是 scroll_box 路径,编辑区右侧滚动条走的是 puck_control。两者结构完全不同:
-
scroll_box控制滑块整体容器尺寸和背景,关键参数是content_margin和layer0.tint -
puck_control只出现在编辑区垂直/水平滚动条中,依赖贴图(layer0.texture),侧边栏不加载该贴图 - 在侧边栏规则里误加
layer0.inner_margin或layer0.texture不生效,还可能导致渲染异常
如果你的主题里没找到带 sidebar 上下文的 scroll_box,说明它复用了全局规则——那就直接改那个最通用的、没加 attributes 限制的 scroll_box rule。
深色主题下滑块看不清?调 layer0.tint 和 layer0.opacity
调宽之后发现滑块还是灰蒙蒙的?不是宽度问题,是颜色对比度太低。侧边栏滚动条滑块的颜色由 layer0.tint(RGB 三元整数数组)和 layer0.opacity 共同决定。
-
"layer0.tint": [160, 160, 160]是偏亮的浅灰,适合深色背景;[80, 80, 80]更暗,慎用 -
layer0.opacity建议保持在0.7–0.9,设为1.0可能太刺眼 - 别碰
scroll_bar_background的opacity:它只影响轨道背景层,不作用于滑块本身
真正容易被忽略的是:改完主题文件必须重启 Sublime 或执行 UI: Reload Theme(Ctrl+Shift+P 输入),否则变化不会生效。而且一旦误删 JSON 结构或写错语法,整个 UI 可能崩溃——务必先备份原文件。











