跳至内容

设置

警告

此页面可能包含过时或不完整的信息。您可以在默认设置文件(**首选项 → 设置** 或 Default/Preferences.sublime-settings)中查看大多数可用设置的描述。

另请参阅

设置用户指南 : 解释 Sublime Text 中设置的工作原理。

全局设置

这些设置只能从 Preferences.sublime-settingsPreferences ({platform}).sublime-settings 中修改。

theme : 要使用的主题。接受文件基本名称(例如:Default.sublime-theme)。

scroll_speed : 设置为 0 以禁用平滑滚动。设置为 01 之间的值以使滚动速度变慢,或设置为大于 1 的值以使滚动速度变快。

hot_exit : 使用启用了 hot_exit 的应用程序或与项目关联的窗口退出时,将立即关闭该窗口,不会提示。未保存的修改和打开的文件将在下次启动时保留并恢复。

remember_open_files : 确定是否重新打开 Sublime Text 最后关闭时打开的缓冲区。

open_files_in_new_window : 仅限 macOS。当从 Finder 或通过拖放到停靠图标打开过滤器时,这将控制是否创建新窗口。

close_windows_when_empty : 关闭窗口,只要最后一个文件关闭,除非窗口中有一个文件夹打开。

show_full_path : 在标题栏中显示文件的完整路径。

preview_on_click : 如果为 true,则在侧边栏中单击文件时预览文件内容。双击或编辑预览将打开文件并为其分配一个选项卡。

folder_exclude_patterns : 从侧边栏、转到任何位置等中排除匹配的文件夹。

file_exclude_patterns : 从侧边栏、转到任何位置等中排除匹配的文件。

binary_file_patterns : 从转到任何位置和在文件中查找中排除匹配的文件,但不排除侧边栏。

show_tab_close_buttons : 如果为 false,则隐藏选项卡的关闭按钮,直到鼠标悬停在选项卡上。

mouse_wheel_switches_tabs : 如果为 true,则滚动鼠标滚轮将导致选项卡切换,如果光标位于选项卡区域。

open_files_in_new_window : 仅限 macOS。当从 Finder 或通过拖放到停靠图标打开过滤器时,这将控制是否创建新窗口。

ignored_packages : 将被忽略(不加载)的软件包列表。

文件设置

空白和缩进

auto_indent : 切换自动缩进。

tab_size : 一个制表符被认为等于的空格数。

translate_tabs_to_spaces : 确定是否在按下 时将制表符字符替换为 tab_size 个空格。

use_tab_stops : 如果 translate_tabs_to_spacestrue,则将使

每按一次键插入/删除 tab_size 个空格。

trim_automatic_white_space : 切换由 auto_indent 添加的空白的删除。

detect_indentation : 设置为 false 以禁用在加载缓冲区时检测制表符与空格。如果设置为 true,它会自动修改 translate_tabs_to_spacestab_size

draw_white_space : 有效值:noneselectionall

trim_trailing_white_space_on_save : 设置为 true 以在保存时删除尾随空白。

视觉设置

always_show_minimap_viewport : 如果设置为 true,则它将始终在小地图上显示突出显示当前文档位置的矩形;默认值为 false,它仅在鼠标悬停在小地图上时显示位置。

color_scheme : 设置用于文本突出显示的颜色。接受以数据目录为根的路径(例如:Packages/Color Scheme - Default/Monokai Bright.tmTheme)。

font_face : 用于可编辑文本的字体。

font_size : 可编辑文本的字体大小。

font_options : 有效值:bolditalicno_antialiasgray_antialiassubpixel_antialiasdirectwrite(Windows)。

gutter : 切换显示边距。

rulers : 显示垂直规则的列。接受数字值的列表(例如 [79, 89, 99])或单个数字值(例如 79)。

draw_minimap_border : 设置为 true 以在对应于视图当前可见文本的小地图区域周围绘制边框。活动颜色方案的 minimapBorder 键控制边框的颜色。

highlight_line : 设置为 false 以停止突出显示带有光标的行。

line_padding_top : 每行顶部的额外间距,以像素为单位。

line_padding_bottom : 每行底部的额外间距,以像素为单位。

scroll_past_end : 设置为 false 以禁用滚动到缓冲区末尾之外。如果为 true,Sublime Text 将在最后一行和窗口底部之间留出宽阔的空白边距。

line_numbers : 切换在边距中显示行号。

word_wrap : 如果设置为 false,长行将被剪切而不是换行。水平滚动屏幕以查看剪切的文本。

wrap_width : 如果大于 0,则在指定列处换行长行,而不是窗口宽度。仅当 word_wrap 设置为 true 时才生效。

indent_subsequent_lines : 如果设置为 false,换行将不会缩进。仅当 word_wrap 设置为 true 时才生效。

draw_centered : 如果设置为 true,文本将居中绘制而不是左对齐。

match_brackets : 设置为 false 以禁用对光标周围的括号进行下划线。

match_brackets_content : 如果您希望括号仅在光标位于括号旁边时才突出显示,请将其设置为 false

match_brackets_square : 设置为 false 以停止突出显示方括号。仅当 match_bracketstrue 时才生效。

match_brackets_braces : 设置为 false 以停止突出显示花括号。仅当 match_bracketstrue 时才生效。

match_brackets_angle : 设置为 false 以停止突出显示尖括号。仅当 match_bracketstrue 时才生效。

自动行为

auto_match_enabled : 切换引号、括号等的自动配对。

save_on_focus_lost : 设置为 true 以在切换到其他文件或应用程序时自动保存文件。

find_selected_text : 如果为 true,则选定的文本将在显示查找面板时复制到查找面板中。

word_separators : 被认为将单词分隔开的字符,用于诸如前进光标等操作。并非在每个需要单词分隔符概念的上下文中使用(例如,单词换行)。在某些上下文中,文本可能会根据其他标准进行标记(例如,语法定义规则)。

ensure_newline_at_eof_on_save : 在保存时,如果文件末尾没有新行,则始终添加一个新行。

系统和杂项设置

is_widget : 如果缓冲区是对话框中的输入字段,而不是常规缓冲区,则返回 true

spell_check : 切换拼写检查器。

dictionary : 拼写检查器要使用的词典。接受以数据目录为根的路径(例如 Packages/Language - English/en_US.dic)。您可以 添加更多词典

fallback_encoding : 当无法自动确定编码时使用的编码。ASCII、UTF-8 和 UTF-16 编码将自动检测。

default_line_ending : 确定用于指定新行的字符。有效值:system(操作系统相关)、windowsCRLF)和 unixLF)。

tab_completion : 确定按下 是否会插入补全。

构建和错误导航设置

result_file_regexresult_line_regex : 用于从转储到视图或输出面板的某些输出中提取错误信息的正则表达式。遵循与 构建系统中的错误捕获 相同的规则。

result_base_dir : 基于使用 result_file_regexresult_line_regex 提取的信息,开始查找有问题的文件的文件夹。

build_env : 默认情况下添加到构建系统的路径列表。

文件和目录设置

default_dir : 设置视图的默认保存文件夹。

输入设置

command_mode : 如果设置为 true,缓冲区将忽略按键。在模拟 Vim 的模式行为时很有用。