# 属性文件

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

Properties files  是具有  `.properties`  扩展名的文本文件，包含以键值对形式存储的本地化字符串，可以在用户界面中访问和渲染。

IntelliJ IDEA 用以下图标标记这些文件： ![属性文件](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.fileTypes.editorConfig.svg)。

IntelliJ IDEA 也识别 XML 格式的属性文件。 它们标有图标 ![XML properties 文件](https://resources.jetbrains.com/help/img/idea/2026.3/properties.icons.xmlProperties.svg)。

可以将多个具有相同基础名称和特定语言后缀的属性文件组合成一个 [resource bundle](resource-bundle.html)，以便使用。

Procedure: 创建一个 properties 文件

1. 右键点击一个要创建文件的目录。

2. 从目标目录的上下文菜单中选择  `新建 | 文件` 。

3. 在   新建文件  对话框中，输入带有相应扩展名的文件名  `.properties` ，然后点击   OK  。

> **Note:**
> 如果您创建了多个具有相同名称和不同语言环境后缀的文件（例如，  `myProp_en.properties` 、  `myProp_fr.properties` 等），这些属性文件将会被合并到一个 [资源包](resource-bundle.html)中。

## 属性文件的编码

在 IntelliJ IDEA 中，属性文件的默认编码为 ISO-8859-1。 还可以对所选编码未定义的字符使用转义序列。 或者，可以选择在项目级别为属性文件定义不同的默认编码。

Procedure: 配置属性文件的默认编码

1. 在   设置  对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择  `编辑器 | 文件编码` 。

2. 从   属性文件的默认编码方式  列表中选择编码。

3. 如有必要，启用   透明的 native 到 ASCII 转换   以显示本地字符（即未在 [ISO-8859-1](https://en.wikipedia.org/wiki/ISO/IEC_8859-1) 中定义的字符），而不是相应的转义序列。

有关更多信息，请参见 [编码](encoding.html)。

如果在设置中将属性文件的默认编码设置为 UTF-8 属性默认选项，并且 IntelliJ IDEA 在属性文件中遇到 UTF-8 不支持的字符，则 IntelliJ IDEA 会自动将该属性文件的编码切换为 ISO-8559-1。

![默认属性文件编码设置](https://resources.jetbrains.com/help/img/idea/2026.3/default_properties_file_encoding_setting.png)

如果属性文件使用 UTF-8 编码，并且 IntelliJ IDEA 识别出版本为 8 或更早版本的 Java 代码（例如，在服务器运行时中）访问包含未在 ISO-8859-1 字符集中定义的字符的属性文件，则   转换为转义序列   检查允许将不符合要求的字符转换为转义序列以实现兼容性。

![转换为转义序列的检查](https://resources.jetbrains.com/help/img/idea/2026.3/convert_to_escape_sequences.png)

