必须同时设置"tab_size":4和"translate_tabs_to_spaces":true，否则按Tab键仍插入\t导致Python/YAML报错；还需禁用"detect_indentation":false防覆盖，并确保color_scheme路径准确、大小写敏感。
Sublime Text 的首选项不是堆参数就能变好用，而是要精准解决你此刻正卡住的问题：缩进错乱、字体发虚、主题不生效、保存后换行崩掉……改对几个关键项，比全量复制别人配置管用十倍。
tab_size 和 translate_tabs_to_spaces 必须成对设
只改 tab_size 不改 translate_tabs_to_spaces，按 Tab 键照样插 \t，Python 或 YAML 一运行就报 IndentationError。这两个值是联动的：
-
tab_size只控制显示宽度和视觉对齐，不影响实际插入字符 -
translate_tabs_to_spaces才决定按 Tab 键时插的是空格还是制表符 - Python/JS/HTML 项目建议设为
{"tab_size": 4, "translate_tabs_to_spaces": true} - Shell 脚本或 Makefile 若依赖真实
\t，必须设"translate_tabs_to_spaces": false - 加
"detect_indentation": false可禁用自动探测，避免打开他人文件时被覆盖
color_scheme 路径写错主题就白配
复制别人配置里的 color_scheme 值，90% 情况下主题不生效——因为路径指向他本地硬盘。Sublime 只认三种格式，且后缀敏感：
- 内置主题：必须以
Packages/开头，如"Packages/Color Scheme - Default/Monokai.sublime-color-scheme" - 用户自定义主题：放
Packages/User/下，路径写成"Packages/User/MyScheme.sublime-color-scheme"（新版推荐.sublime-color-scheme，旧版用.tmTheme） - 绝对路径（不推荐）：Windows 用
file:///C:/...，macOS/Linux 用file:///Users/xxx/...，换机器就失效 - 路径大小写必须精确，
monokai和Monokai是两个东西
font_face 和 font_options 连字支持要看真本事
启用了 liga 却没效果？不是配置错了，是字体或系统不支持：
- Fira Code、JetBrains Mono 支持连字；Consolas、Courier New 不支持
- macOS 默认支持；Windows 需开启 ClearType 并确保 Sublime 启动时能读到字体路径
- 字体名含空格（如
IBM Plex Mono）必须用双引号包裹，不能写成IBM\ Plex\ Mono - Linux 下可能需手动安装字体并刷新缓存：
fc-cache -fv -
"subpixel_antialias": true在非 Retina 屏上常导致文字发虚，建议删掉或留空数组
ignored_packages 禁用插件要重启才生效
在 ignored_packages 里删掉某个插件名，结果它还在跑？常见原因有三个：
- 大小写必须完全一致：
"Git"≠"git"≠"GIT" - 插件名不是文件夹名，比如
Package Control对应的文件夹是Package Control，但有些插件名带空格或连字符，得去Packages/目录下确认 - 改完必须重启 Sublime，热重载不触发插件卸载逻辑
- 如果想临时禁用，用命令面板输入
Package Control: Disable Package更稳妥
真正麻烦的从来不是“怎么配”，而是“为什么配了没用”——路径大小写、后缀类型、重启要求、字体底层支持，这些细节不盯住，再全的配置清单也救不了现场。
