Sublime Text全局首选项必须手动修改Packages/User/Preferences.sublime-settings文件才生效，直接改默认配置或仅调菜单选项无效；安装后需先确认Package Control、打开用户设置并验证可写性，再配置tab_size、translate_tabs_to_spaces等核心参数。
Sublime Text 安装后，全局首选项里的代码风格设置不是“开箱即用”的，必须手动修改 Preferences.sublime-settings 文件才能生效；直接改默认配置或只调菜单选项不会持久生效。
安装 Sublime Text 后立即要做的三件事
安装完成启动后，别急着写代码，先做这三步：确认 Package Control 已就位、打开用户设置文件、验证当前配置是否可写。很多后续问题（比如主题不生效、缩进乱掉）其实都卡在这一步。
- 按
Ctrl+`（Windows/Linux）或Cmd+`（macOS）呼出控制台，粘贴官方安装脚本——如果返回Package Control installed. Restart Sublime Text.说明成功；没反应或报错，说明没装好，后续所有插件和主题都无法安装 - 重启后，用
Ctrl+Shift+P打开命令面板，输入Preferences: Settings，确保右侧窗口是空的或只有你写的配置——左侧是只读默认值，改它无效 - 保存前检查右下角 JSON 格式是否合法：Sublime 会标红语法错误，常见的是末尾多逗号、引号不匹配、中文标点混入
全局缩进与空格行为必须设这两个键
tab_size 和 translate_tabs_to_spaces 是影响所有语言文件缩进行为的核心参数，它们不依赖插件，但一旦设错，Python 会缩进报错、JS 会格式混乱、团队协作时 diff 全是空格差异。
-
"tab_size": 4表示一个 Tab 视觉上占 4 个字符宽度；但它不决定实际插入什么——这点常被误解 -
"translate_tabs_to_spaces": true才真正决定按下 Tab 键时插入的是空格还是 Tab 字符；设为false会导致混合缩进（Tab + 空格），Git diff 难读，ESLint 报no-mixed-spaces-and-tabs - 不要设
"detect_indentation": false——虽然看起来“更可控”，但它会禁用 Sublime 自动识别已有文件缩进的能力，打开别人项目时第一行就错位
字体、行距与视觉辅助项建议一次性配齐
这些设置虽不直接影响代码逻辑，但长期编码中眼睛疲劳、光标丢失、行长超界等问题，90% 都源于初始配置遗漏。
-
"font_face": "Fira Code"或"JetBrains Mono"——等宽编程字体，带连字（ligature）支持，但需额外启用"font_options": ["gray_antialias", "subpixel_antialias"]（macOS 可省略） -
"line_padding_top": 2和"line_padding_bottom": 2比默认 0 更易区分相邻行，尤其在高密度函数里 -
"rulers": [80, 120]——双竖线比单条更实用：80 是 PEP8 推荐，120 是现代屏宽下的安全线；设成[80]容易误判长字符串换行点 -
"draw_white_space": "all"能显示所有空格和 Tab，调试缩进问题时开它，确认后再关——很多人只设"selection"，结果看不见隐藏的 Tab
主题与配色方案路径必须严格匹配包名结构
即使 Package Control 显示安装成功，"theme" 和 "color_scheme" 的路径写错一个字母或斜杠方向，界面就不会变；而且错误不报错，只静默回退到默认样式。
- 主题路径格式必须是
"theme": "Material-Theme.sublime-theme"，结尾的.sublime-theme不能省；Material Theme 安装后实际文件名就是这个，不是MaterialTheme.sublime-theme - 配色方案路径必须带
Packages/前缀，例如"color_scheme": "Packages/Material Theme/schemes/Material-Theme.tmTheme"——注意中间有空格，且大小写敏感；Material Theme是插件名，schemes是其子目录 - 如果用的是 Sublime Text 4，部分新主题（如
ayu）使用.sublime-color-scheme后缀，路径写成Packages/ayu/ayu-light.sublime-color-scheme，和老版.tmTheme不兼容
最常被忽略的其实是缓存：改完设置保存后，如果界面没变化，别反复重装插件，先关掉 Sublime，删掉 %LOCALAPPDATA%\Sublime Text 3\Cache\（Windows）或 ~/Library/Caches/Sublime Text 3/（macOS）里的内容再重启——Sublime 有时会缓存旧主题资源，导致新配置加载失败。
