Preferences → Settings右侧用户设置中应填入JSON格式参数，如"font_size": 13,"tab_size": 4,"translate_tabs_to_spaces": true,"word_wrap": true,"highlight_line": true,"auto_complete": true，仅修改右侧用户设置面板，Sublime会自动合并配置。
Preferences → Settings 里该填什么参数
打开 Preferences → Settings 后，左右两个面板中，**只改右侧“用户设置”（User Settings）**，左侧是只读的默认配置。直接覆盖写入 JSON 对象即可，不需要保留原有内容——Sublime 会自动合并，但手动写全更可控。
常见且实用的参数组合如下，按真实使用频率排序：
-
"font_size": 13：Windows/macOS/Linux 下都建议设为 12–14，太小伤眼，太大浪费空间；UOS 或高分屏可设为 14–16 -
"tab_size": 4：Python/JS/Go 等主流语言默认缩进为 4，设成 2 容易和团队格式冲突 -
"translate_tabs_to_spaces": true：强制把 Tab 转为空格，避免混用导致 Git diff 爆炸 -
"word_wrap": true：长行自动换行，看 Markdown 或日志时很省事；但写代码时不推荐开，影响对齐判断 -
"highlight_line": true：当前行高亮，定位光标位置更直观，尤其在大文件中 -
"auto_complete": true：补全开关，关了等于自废武功；若误触发频繁，可配合"auto_complete_delay": 500延迟触发（单位毫秒）
中文乱码、保存失败、路径含空格报错怎么防
这些不是插件问题，而是初始配置没堵住底层漏洞。关键就三点：
- Windows 用户务必在安装时勾选
Add to PATH，否则subl命令根本不可用，后续所有脚本集成（如 Git commit-msg 编辑、VS Code 替代方案）全部失效 - 所有路径（安装目录、项目路径、Build System 中的
shell_cmd）**不能含中文或空格**，比如C:My Projectscode会导致g++找不到源文件，错误信息常为no such file or directory - Linux/macOS 用户如果用
subl --command调用功能，必须提前运行subl --install-shell-commands（macOS）或确保/usr/local/bin/subl符号链接存在，否则命令行调用直接静默失败
Package Control 安装失败的硬核排查点
Ctrl+` 粘贴安装脚本后没反应？别急着重试，先看控制台底部是否出现 ImportError: No module named urllib.request —— 这说明你正在用 Sublime Text 2，而脚本是为 ST3/ST4 写的。ST2 已停止维护，官网不再提供下载，强行用会遇到 HTTPS 请求失败、插件加载异常等连锁问题。
正确做法：
- 确认版本：
Sublime Text → About Sublime Text，显示 Build 41xx 才是 ST4；Build 32xx 是 ST3；Build 22xx 是 ST2（立刻卸载） - ST4 必须用带
sha256校验的安装脚本，旧版脚本会因证书变更失败；官方最新脚本地址在 packagecontrol.io/installation 动态更新 - 如果控制台卡在
downloading package control不动，大概率是公司代理或防火墙拦截了https://packagecontrol.io/，需手动下载Package Control.sublime-package放到Sublime Text 3/Packages/目录（注意路径名里带空格要转义）
Build System 配置里最容易写错的三处
写完 C++/Python/Java 的 Build System 文件，Ctrl+B 没反应？八成栽在这几个地方：
-
"shell_cmd"中的路径斜杠：Windows 必须用\或正斜杠/，不能用单反斜杠（JSON 解析会当转义符处理，"C:MinGWing++.exe"直接报错） -
"working_dir"值必须是字符串，不能写成file_path（漏引号），正确写法是"$file_path"；变量名大小写敏感，$File_path无效 - Python 构建时若用
python -u，-u参数必须紧挨python，写成"python" "-u" "$file"会被当成两个独立命令，导致TypeError: expected str, bytes or os.PathLike object
真正麻烦的从来不是写几行 JSON，而是某处少了个引号、多了一层嵌套、或者变量名拼错一个字母——Sublime 不报语法错误，只默默不执行。
