侧边栏宽度无法拖动是因启用了sidebar_width配置项,该值会强制固定宽度;需检查并删除Preferences→Settings–User中的"sidebar_width":xxx行才能恢复拖动。

侧边栏宽度无法拖动?先确认是否启用了 sidebar_width 锁定机制
Sublime Text 默认允许手动拖动侧边栏分隔线调整宽度,但一旦在用户设置中显式设置了 sidebar_width,它就会覆盖拖动行为——不是“卡住”,而是被配置值强制固定。常见现象是:拖完松手立刻弹回原宽,或完全无法拖动。
检查你的 Preferences → Settings – User 是否存在这一行:
{
"sidebar_width": 240
}
如果有,删掉这行或注释掉即可恢复自由拖动。注意:这个键名大小写敏感,写成 sidebarWidth 或 SidebarWidth 都无效,也不会报错,只是被忽略。
想永久固定某个宽度?用 sidebar_width 但要注意兼容性
该配置项自 Sublime Text 4(Build 4126+)起正式支持,旧版(ST3)即使写上也无效果。如果你在 ST3 中看到它生效,那其实是主题或插件的模拟行为,不可靠。
-
sidebar_width单位是像素,只接受正整数(如220),不支持百分比或em - 设为过小(如
50)会导致文件名截断、图标重叠,部分主题(如ayu)可能直接隐藏文本只留图标 - 多显示器缩放场景下,该值按逻辑像素计算,高 DPI 屏幕上可能显得更窄
目录树显示范围受限?本质是 folder_exclude_patterns 和 file_exclude_patterns 在过滤
侧边栏“看不见”某些文件夹,并非宽度问题,而是被排除规则拦截了。默认设置里已预置常见构建/缓存目录,但容易漏掉项目级配置。
检查并修改 Preferences → Settings – User 中的这两项:
{
"folder_exclude_patterns": [".git", "__pycache__", "node_modules", ".venv"],
"file_exclude_patterns": ["*.pyc", "*.log", ".DS_Store"]
}
注意:folder_exclude_patterns 是对文件夹**名称**匹配(不看路径深度),所以写 "src/lib" 不会生效;如需按路径排除,得用插件(如 SideBarEnhancements 的自定义过滤)。
想动态控制某项目侧边栏?优先用 Project Settings 而非全局设置
全局设置影响所有项目,而实际需求常是“仅当前项目收窄侧边栏 + 排除 dist”。这时应编辑 Project → Edit Project,在 settings 块内加:
{
"folders": [
{
"path": "."
}
],
"settings": {
"sidebar_width": 180,
"folder_exclude_patterns": [".git", "dist", "build"]
}
}
这样切换项目时宽度和过滤规则自动切换,避免不同项目互相干扰。别忘了:项目设置中的 sidebar_width 同样只在 ST4 生效,ST3 下会被静默忽略。
真正麻烦的是混合环境——比如团队有人用 ST3、有人用 ST4,又共用同一份 .sublime-project。这时候 sidebar_width 字段得加注释说明兼容性,否则新人拉代码后发现“侧边栏变窄了却调不回来”,第一反应往往是误以为 UI 崩溃。

















