便携版自动换行设置与安装版一致,唯一区别是配置文件位于便携目录的Data\Packages\User\Preferences.sublime-settings(Windows/Linux)或Sublime Text.app/Contents/Resources/Data/Packages/User/Preferences.sublime-settings(macOS),且"word_wrap": true必须为布尔值,非字符串或数字。

Sublime Text 便携版的自动换行设置方式和安装版完全一致,唯一区别是配置文件路径不依赖系统目录,而是落在便携目录内;改错位置或误用字符串值是失效主因。
便携版配置文件在哪?别去 C:\Users 或 ~/Library 找
便携版所有设置都存于你解压/安装的根目录下,典型路径是:
-
Sublime Text\DATA\Packages\User\Preferences.sublime-settings(Windows/Linux) -
Sublime Text.app/Contents/Resources/Data/Packages/User/Preferences.sublime-settings(macOS)
不是系统用户目录下的 Packages/User,也不是 Installed Packages。打开 Sublime → Preferences → Settings 后,右侧标签页标题会显示 “Preferences.sublime-settings – User”,且路径明确指向便携目录内的 DATA 子目录——这是唯一有效的修改位置。
"word_wrap": true 必须是布尔值,写成 "true" 就静默失效
便携版不额外校验类型,但 Sublime 引擎本身只认布尔值 true 或 false。以下写法全部无效:
-
"word_wrap": "true"(字符串) -
"word_wrap": "auto"(旧文档误导项,已弃用) -
"word_wrap": 1(数字)
正确写法只有一种:"word_wrap": true,并建议配套加上:"wrap_width": 0(按窗口自适应,对中文、URL、变量名最友好)。
为什么改了 Preferences.sublime-settings – User 还不生效?
便携版同样遵循“视图 > 语法专属 > 用户”三级优先级,常见覆盖源有:
- 右下角状态栏显示
Wrap: Off?点它直接切换——这个操作写入当前视图设置,优先级最高,会盖掉你刚写的用户配置 - 已打开的 Python / JSON 文件自带语法专属设置(如
Python.sublime-settings),路径在DATA\Packages\Python\,里面若含"word_wrap": false,就会生效 - 插件(如
SideBarEnhancements)在后台调用view.settings().set('word_wrap', False),尤其在右键菜单触发后
排查顺序:先点状态栏 Wrap: Off 切成 On;再检查是否为当前文件类型单独建了语法设置;最后临时禁用插件验证。
便携版特有的坑:DATA 目录权限与同步冲突
便携版依赖 DATA 目录可读写,但某些场景下会出问题:
- 把便携目录放在 OneDrive / iCloud / Dropbox 同步文件夹里?JSON 文件保存瞬间可能被同步进程锁住,导致设置不生效或回滚
- 多设备共用同一份便携目录(比如 U 盘插不同电脑)?
DATA下的Local子目录含缓存和会话数据,混用可能引发视图状态异常,间接影响word_wrap行为 - 从旧版 Sublime 升级便携包时,
DATA\Packages\User若被覆盖或清空,你的Preferences.sublime-settings就丢了
安全做法:便携目录远离云同步路径;升级前手动备份 DATA\Packages\User 整个文件夹;不要跨平台混用同一份便携包(Windows/macOS 架构不同)。











