Sublime Text stores configuration data in .sublime-settings files. Flexibility comes at the price of a slightly complex system for applying settings. However, here’s a rule of thumb: Sublime Text把配置信息保存在 .sublime-settings 文件中。为了拥有较好的灵活性，作为代价， 需要一个略显繁琐的系统来管理设置项。我们先来说一条基本原则吧：
Always place your personal settings files under Packages/User to guarantee that they will take precedence over any other conflicting settings files. 个人定义的设置项文件一定要保存到 Packages/User 目录下，这样就能保证在发生冲突的时候，你定 义的文件拥有较高的优先级。
With that out of the way, let’s unveil the mysteries of how settings work to please masochistic readers. 这一点解释清楚之后，咱们就可以揭开设置项工作的具体原理了，从而满足部分喜欢受虐读者的需求。
（译者注：作者原文是masochistic，可以翻译成受虐狂，这里感觉也可以理解成求知若渴的人，求指正）
Format 文件格式 ==========
Settings files use JSON and have the .sublime-settings extension. 设置项文件是以 .sublime-settings 作为扩展名的的JSON文件。
Types of Settings 设置项文件类型 =================
The purpose of each .sublime-settings file is determined by its name. These names can be descriptive (like Preferences (Windows).sublime-settings or Minimap.sublime-settings), or they can be related to what the settings file is controlling. For example, file type settings need to carry the name of the .tmLanguage syntax definition for the file type. Thus, for the .py file type, whose syntax definition is contained in Python.tmLanguage, the corresponding settings files would be called Python.sublime-settings. 可以通过 .sublime-settings 文件的名字看出它的用途。这些文件的名字可能具有一定的描述性（例如 Preferences (Windows).sublime-settings 或者 Minimap.sublime-settings），亦或是跟 它所控制的内容有关联。以控制文件类型的设置项文件为例，命名时要求必须有与之对应的 .tmLanguage 语法定义文件。因此，对于 .py 文件类型，它的语法定义信息存放在 Python.tmLanguage 文件中， 那么对应的文件类型设置项文件就该被叫做 Python.sublime-settings 。
Also, some settings files only apply for specific platforms. This can be inferred from the file names: Preferences (Windows).sublime-settings, Preferences (Linux).sublime-settings, etc. 除此之外，某些设置文件只能作用于某个特定的平台。可以通过文件名进行推断，例如： Preferences (Windows).sublime-settings 和 Preferences (Linux).sublime-settings 。
This is important: Platform-specific settings files in the Packages/User folder are ignored. This way, you can be sure a single settings file overrides all the others. 有一点特别 重要 ：存放在 Packages/User 目录中的平台相关的设置文件将被忽略。通过这种方式， 就可以保证单个设置文件内容可以覆盖其他所有设置文件的内容了。
How to Access and Edit Common Settings Files 如何访问并修改公共的设置项文件 ============================================
Unless you need very fine-grained control over settings, you can access the main configuration files through the Preferences | Settings - User and Preferences | Settings - More menu items. Editing Preferences - Settings Default isn’t a smart thing to do, because changes will be reverted with every update to the software. However, you can use that file for reference: it contains comments explaining the purpose of all available global and file type settings. 除非你对设置项有非常精确的掌控力，否则，你只需要通过 Preferences | Settings - User 和 Preferences | Settings - More 菜单项来访问主要的配置文件。编辑 Preferences - Settings Default 这个文件并不是一件明智的事情，因为每次版本升级这些修改都 将被重置。不过，你确实可以把这些文件当作一个不错的参考资料：默认设置项文件里面包含了解释所有能 为你所用的全局设置项和文件类型设置项的说明注释。
Order of Precedence of .sublime-settings Files .sublime-settings 文件的优先级顺序 ==================================================
The same settings file (such as Python.sublime-settings) can appear in multiple places. All settings defined in identically named files will be merged together and overwritten according to predefined rules. See Merging and Order of Precedence for more information. 名字相同的设置项文件（例如，都叫 Python.sublime-settings 的文件）可以在多个位置出现。以相同 名称命名的设置项文件中的内容都将按预定义的规则进行合并或者覆盖。请参考 排序与优先级顺序 这一小节以了解更多信息。
Let us remember again that any given settings file in Packages/User ultimately overrides every other settings file of the same name. 再说明一次，在 Packages/User 目录下的设置项文件拥有最高优先级，并且最终会覆盖其他同名设置项 文件中的相同内容。
In addition to settings files, Sublime Text maintains session data –settings for the particular set of files being currently edited. Session data is updated as you work on files, so if you adjust settings for a particular file in any way (mainly through API calls), they will be recorded in the session and will take precedence over any applicable .sublime-settings files. 除了设置项文件以外，Sublime Text还维护 会话 数据 —— 一些针对正在编辑的文件集所应用的设置项。 会话数据是在你编辑文件的过程中发生变化的，所以，无论你通过何种方式调整了一个特定文件的设置项 （主要是通过API调用的方式），这些设置项的变更将被记录在当前的会话中，并且将拥有比所有符合条件的 .sublime-settings 文件更高的优先级。
To check the value of a setting in effect for a particular file, use view.settings().get(<setting_name>) from the console. 如果想要检查针对特定文件当前正在发挥作用的设置项的值，可以在控制台中输入 view.settings().get(<设置项名称>) 命令。
Lastly, it’s also worth noting that some settings may be adjusted automatically
for you. Keep this is mind if you’re puzzled about some setting’s value. For
instance, this is the case for certain whitespace-related settings and the
syntax setting.
最后需要注意的是，某些设置项的值可能会被系统自动进行调整。请记住这一点，这样一来你就能够解释某
些令你困惑的设置项内容了。举例来说，在查看某些与空格相关的设置项的值，以及某些 语法 设置项
内容的时候，就有可能遇到这种问题。
Below, you can see the order in which Sublime Text would process a hypothetical hierarchy of settings for Python files on Windows: 接下来你将看到Sublime Text是如何处理Windows平台上Python相关的设置项文件的，这里的设置项文件 目录结构是虚构的：
- Packages/Default/Preferences.sublime-settings
- Packages/Default/Preferences (Windows).sublime-settings
- Packages/User/Preferences.sublime-settings
- Packages/Python/Python.sublime-settings
- Packages/User/Python.sublime-settings
- Session data for the current file
- 当前文件的会话数据
- Auto adjusted settings
- 由系统自动调整的设置项内容
（译者注：分析下优先级，可以得到结论：全局默认项 < 平台默认项 < 用户设置项 < 语言相关的设置 < 由用户指定的语言相关的设置 < 会话数据 < 系统调整的数据）
Global Editor Settings and Global File Settings 全局编辑器设置以及全局文件设置 ===============================================
These settings are stored in Preferences.sublime-settings and Preferences (<platform>).sublime-settings files. The defaults can be found in Packages/Default. 这类全局设置项内容一般被保存在名为 Preferences.sublime-settings 和 Preferences (<平台名称>).sublime-settings 的文件中。默认的全局设置项存放在 Packages/Default 目录中。
Valid names for <platform> are Windows, Linux, OSX.
上面所说的 <平台名称> 可能是 Windows， Linux 或者 OSX。
File Type Settings 文件类型设置项 ==================
If you want to target a specific file type, name the .sublime-settings file after the file type’s syntax definition. For example, if our syntax definition was called Python.tmLanguage, we’d need to call our settings file Python.sublime-settings. 如果你想针对某个特定的文件类型进行一些配置，那请根据这个文件类型的语法定义文件名称来对应的命名 .sublime-settings 文件。举例来说，如果我们的语法定义文件叫 Python.tmLanguage ，那么 设置项文件的名称就应该叫 Python.sublime-settings 。
Settings files for specific file types usually live in packages, like Packages/Python, but there can be multiple settings files for the same file type in separate locations. 通常情况下，某个特定文件类型的设置项信息一般存放在包组文件夹的一个目录中，例如 Packages/Python， 但是，与同一个文件类型相关的多个设置项文件也有可能被存放在不同的位置。
Similarly to global settings, one can establish platform-specific settings for file types. For example, Python (Linux).sublime-settings would only be consulted under Linux. 与全局设置项类似，也可以为文件类型设置项信息创建平台相关的内容。例如只有在Linux平台下，保存在 Python (Linux).sublime-settings 中的设置项内容才会被系统考虑。
Also, let us emphasize that under Pakages/User only Python.sublime-settings would be read, but not any Python (<platform>).sublime-settings variant. 需要特别指出的一点是，在 Packages/User 目录下，只有 Python.sublime-settings 文件会被 加载，所有以 Python (<平台名称>).sublime-settings 命名的平台相关的变种都不会被考虑。
Regardless of its location, any file-type-specific settings file has precedence over every global settings file affecting file types. 不管文件类型设置项信息保存在哪里，它拥有比保存在全局设置项文件中的、影响文件类型的设置项都高的 优先级。
Where to Store User Settings (Once Again) （再说一次）用户指定的设置项信息应该保存到哪里 ============================================
Whenever you want to save settings, especially if they should be preserved between software updates, place the corresponding .sublime-settings file in Packages/User. 无论何时，当你想要保存一些设置的时候，尤其是那些在软件升级前后应该被保留的设置，就把它们保存在 Packages/User 目录下的对应 .sublime-settings 文件中吧。