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 不报语法错误,只默默不执行。











