idea 中 properties 文件打开强制为 iso-8859-1 编码打开，如何修改为 utf-8
setting=>Editor=>File Encoding，设置配置文件的默认编码，勾选上 Transparent native-to-ascii conversion
在 IntelliJ IDEA 中，.properties 文件默认以 ISO-8859-1 编码打开。如果你想将其改为以 UTF-8 编码打开，可以按照以下步骤操作：
- 打开 IntelliJ IDEA，并转到 “File”（文件）菜单，然后选择 “Settings”（设置）。
- 在弹出的设置对话框中，找到 “Editor”（编辑器）选项，然后展开它。
- 在 “Editor” 下，选择 “File Encodings”（文件编码）。
- 在右侧窗格中，找到 “Properties Files”（属性文件）。
- 在 “Properties Files” 下，你会看到 “Default encoding for properties files”（属性文件的默认编码）。
- 将其从 “ISO-8859-1” 改为 “UTF-8”。
- 点击 “OK” 保存更改并关闭设置对话框。
现在，当你打开 .properties 文件时，IntelliJ IDEA 将使用 UTF-8 编码进行显示和编辑。
请注意，这只会影响 IntelliJ IDEA 中的文件打开和编辑，而不会更改实际的文件编码。确保你的文件实际上使用 UTF-8 编码，以便与其他工具和系统正确交互。
java 中如何使用 ResourceBundle 读取 i18n 配置
在 Java 中，你可以使用 ResourceBundle 类来读取 i18n（国际化）配置文件。
首先，确保你的 i18n 配置文件（资源包）按照约定的命名规则存放在指定的位置，例如在 src/main/resources 目录下。然后，可以使用 ResourceBundle.getBundle() 方法来加载指定的资源包文件。
下面是一个使用 ResourceBundle 读取 i18n 配置的简单示例：
import java.util.Locale;
import java.util.ResourceBundle;
public class I18nExample {
public static void main(String[] args) {
// 指定要读取的资源包文件名和语言环境
String baseName = "messages";
Locale locale = Locale.getDefault(); // 默认语言环境
// 加载资源包
ResourceBundle bundle = ResourceBundle.getBundle(baseName, locale);
// 根据键获取对应的国际化文本
String greeting = bundle.getString("greeting");
String farewell = bundle.getString("farewell");
// 打印国际化文本
System.out.println(greeting);
System.out.println(farewell);
}
}
在上述示例中，我们使用 ResourceBundle.getBundle() 方法加载名为 messages 的资源包文件，并根据默认的语言环境获取对应的国际化文本。
你可以根据需要，通过传入不同的语言环境参数来读取不同的资源包文件，例如 Locale.US（美式英语）或 Locale.CHINA（中国大陆地区）等。
注意，ResourceBundle 类默认使用 Java 的标准属性文件（.properties）作为资源包文件格式，但也支持其他格式，如 XML 格式的资源包。
properties 中文内容发现打包之后乱码 如何解决？
当在 properties 文件中使用中文内容时，确保以下步骤来避免乱码问题：
-
使用 UTF-8 编码：确保你的 properties 文件以 UTF-8 编码保存，以支持中文字符。在大多数编辑器中，你可以选择文件编码为 UTF-8，以确保正确保存中文字符。
-
properties 文件名：确保你的 properties 文件名不包含任何特殊字符或中文字符，最好使用英文命名。
-
资源包加载时指定编码：在加载资源包时，明确指定 UTF-8 编码。你可以使用
ResourceBundle.Control类来自定义资源包的加载方式，并指定编码方式。以下是一个示例：import java.nio.charset.StandardCharsets; import java.util.Locale; import java.util.ResourceBundle; public class I18nExample { public static void main(String[] args) { String baseName = "messages"; Locale locale = Locale.getDefault(); // 自定义资源包加载方式 ResourceBundle.Control control = new ResourceBundle.Control() { @Override public ResourceBundle newBundle(String baseName, Locale locale, String format, ClassLoader loader, boolean reload) { String bundleName = toBundleName(baseName, locale); String resourceName = toResourceName(bundleName, "properties"); try (var stream = loader.getResourceAsStream(resourceName)) { if (stream != null) { return new PropertyResourceBundle(new InputStreamReader(stream, StandardCharsets.UTF_8)); } } catch (IOException e) { e.printStackTrace(); } return null; } }; // 加载资源包，并指定编码为 UTF-8 ResourceBundle bundle = ResourceBundle.getBundle(baseName, locale, control); // 读取国际化文本 String greeting = bundle.getString("greeting"); String farewell = bundle.getString("farewell"); System.out.println(greeting); System.out.println(farewell); } }在上述示例中，我们自定义了
ResourceBundle.Control类，并在newBundle()方法中使用PropertyResourceBundle加载资源包时指定了 UTF-8 编码。 -
构建项目时检查编码设置：如果你是通过构建工具（如 Maven 或 Gradle）构建项目，确保在项目的构建配置中设置了正确的编码，如 Maven 的
pom.xml文件中的<project.build.sourceEncoding>配置。
遵循上述步骤，你应该能够解决 properties 文件中中文内容乱码的问题，并在打包后正确显示中文字符。
发现 messages.properties 文件只能是 iso-8859-1 是吗？
在 Java 中，.properties 文件默认采用 ISO-8859-1 编码。这是因为早期版本的 Java 平台仅支持该编码。因此，当你创建一个名为 messages.properties 的文件时，默认情况下，它会被假设为 ISO-8859-1 编码。
然而，如果你想在 .properties 文件中使用其他字符集，例如 UTF-8，你可以采取一些额外的步骤来确保正确的编码：
- 将文件的编码格式更改为 UTF-8。在许多文本编辑器中，你可以选择另存为并选择 UTF-8 作为编码选项。
- 在你的 Java 代码中，使用
ResourceBundle时，指定正确的编码，例如：
ResourceBundle bundle = ResourceBundle.getBundle("messages", StandardCharsets.UTF_8);
这将以 UTF-8 编码加载名为 messages.properties 的资源文件。确保在代码中指定与文件实际编码相匹配的编码。
需要注意的是，当使用 UTF-8 编码时，确保你的 Java 代码、构建脚本和其他相关工具都正确地处理和识别 UTF-8 编码。
例如，在 Gradle 构建中，你需要确保使用了正确的编码设置来处理资源文件，如前面提到的 Gradle 配置示例中的 processResources 部分。
gradle 如何指定项目构建的编码
在 Gradle 中指定项目构建的编码，可以通过在 build.gradle 文件中设置 compileJava 任务的编码选项来实现。以下是一个示例：
compileJava {
options.encoding = 'UTF-8'
}
在上述示例中，我们将 compileJava 任务的 options.encoding 属性设置为 'UTF-8'，指定了编译 Java 源代码时使用的编码。
请注意，这只会影响编译过程中源代码的编码，而不会直接影响资源文件（如 properties 文件）的编码。如果你的项目中有其他资源文件需要指定编码，你需要相应地设置其他任务的选项。例如，如果你使用了 processResources 任务处理资源文件，你可以通过类似的方式设置其编码选项：
processResources {
options.encoding = 'UTF-8'
}
确保将上述代码放置在 build.gradle 文件的适当位置，通常是在顶层的 build.gradle 文件或模块的 build.gradle 文件中的 dependencies 块之后。完成后，运行 Gradle 构建命令时，Gradle 将使用指定的编码进行项目构建。
另一种配置方式
要在 Gradle 中指定资源文件的编码格式，你可以使用如下的配置：
tasks.withType(JavaCompile) {
options.encoding = "UTF-8"
}
processResources {
filesMatching('**/*.properties') {
filter {
it.replaceCharset('ISO-8859-1', 'UTF-8')
}
}
}
上述代码片段中，processResources 任务用于处理资源文件。通过 filesMatching('**/*.properties') 指定了要处理的资源文件类型，这里以 .properties 文件为例。然后使用 filter 方法来替换资源文件的字符编码。
在 filter 方法中，使用 replaceCharset('ISO-8859-1', 'UTF-8') 将资源文件的编码从 ISO-8859-1 转换为 UTF-8。你可以根据实际情况调整字符编码的参数。
请确保将这段代码放置在适当的位置，例如在 build.gradle 文件的顶层或适当的任务配置块内。这样，在构建过程中，资源文件就会使用指定的编码格式进行处理。
i18n 语言国际化中，创建资源包（Resource Bundle） 文件夹的位置和名字？
在 i18n 语言国际化中，资源包（Resource Bundle）文件通常存放在项目的 src/main/resources 目录下。
对于 Java 项目，资源包文件的命名约定是使用基本名称和语言标签的组合。
例如，基本名称可以是 messages，然后根据语言不同创建不同的资源包文件。命名约定如下：
- 默认资源包：
messages.properties - 英文资源包：
messages_en.properties -
中文资源包：
messages_zh.properties - 其他语言资源包：根据语言标签创建对应的资源包，例如
messages_fr.properties（法语）、messages_de.properties（德语）等。
在创建这些资源包文件时，你可以将其放置在一个名为 i18n 或 locales 的文件夹中，以便更好地组织和管理国际化资源文件。
总结起来，资源包文件的位置和命名约定如下：
- 位置：
src/main/resources - 命名约定：基本名称 + 语言标签 +
.properties
请根据项目需要和个人偏好来选择合适的文件夹名称和命名约定。
介绍一下 idea 插件的 Localization 语言国际化
在 IntelliJ IDEA 插件开发中，你可以使用 Localization（本地化）来实现插件界面的国际化，使得插件可以适应不同的语言环境。通过本地化，你可以将插件的文本、标签、消息等内容根据用户的语言偏好显示不同的翻译版本。
下面是实现插件本地化的一般步骤：
-
创建资源包（Resource Bundle）：资源包是存储翻译文本的文件，一般以
.properties后缀命名。在插件的src目录下创建一个新的文件夹，命名为resources，然后在其中创建一个名为messages的文件夹。在messages文件夹中创建一个messages.properties文件，该文件将包含插件界面的文本内容的键值对。 -
定义翻译文本：打开
messages.properties文件，在其中按照以下格式定义翻译文本的键值对。键是用于标识翻译文本的唯一标识符，值是对应的翻译文本。
my.plugin.greeting=Hello!
my.plugin.button.label=Click Me!
-
创建其他语言的资源包：为了支持多语言，你可以在
messages文件夹中创建其他语言的资源包文件，例如messages_de.properties（德语）和messages_fr.properties（法语）。在这些文件中，你可以提供相同键的不同翻译文本。 -
在插件代码中使用本地化文本：在插件代码中，你可以使用
PropertiesComponent类或ResourceBundle类来加载本地化的文本。以下是示例代码：
import com.intellij.openapi.components.PropertiesComponent;
import java.util.ResourceBundle;
// 使用 PropertiesComponent 加载本地化文本
String greeting = PropertiesComponent.getInstance().getValue("my.plugin.greeting");
// 使用 ResourceBundle 加载本地化文本
ResourceBundle bundle = ResourceBundle.getBundle("messages.messages");
String buttonLabel = bundle.getString("my.plugin.button.label");
你可以根据需要使用 PropertiesComponent 或 ResourceBundle，根据键获取相应的翻译文本。
-
将插件打包为 JAR 文件：在构建插件时，确保将
resources文件夹及其内容包含在插件的 JAR 文件中。 -
提供多语言支持：为了让用户能够在 IntelliJ IDEA 中选择使用的语言，你可以在插件的
plugin.xml文件中添加<depends>元素，并引用com.intellij.modules.platform插件模块。这样，用户将能够在 IntelliJ IDEA 的设置中选择所需的语言。
以上是一般的插件本地化步骤，可以根据你的插件需求和目标语言进行相应的调整。通过插件本地化，你可以通过插件本地化，你可以提供更好的用户体验，使得插件适应不同语言环境的用户需求。
技巧
以下是一些关于插件本地化的进一步技巧和注意点：
- 处理动态文本：除了静态文本之外，插件可能还包含动态生成的文本，例如动态错误消息或动态标签。
对于这些动态文本，你可以使用 MessageFormat 类或者类似的工具来将变量插入翻译文本中。
String username = getUsername(); // 获取动态文本
String greeting = bundle.getString("my.plugin.greeting");
String formattedGreeting = MessageFormat.format(greeting, username);
-
支持可选的语言：除了支持常见的语言，你也可以考虑支持一些较少使用的语言，这样可以扩大插件的受众范围。
-
处理语言特定的格式：不同语言的格式要求可能不同，例如日期、时间和货币格式等。确保在本地化文本中考虑到这些语言特定的格式，并根据需要进行适当的格式化。
-
考虑 RTL（从右到左）语言：某些语言（如阿拉伯语、希伯来语等）是从右到左书写的，而不是从左到右。当本地化插件时，确保界面的布局和排列适应RTL语言，以提供更好的用户体验。
-
为翻译者提供上下文：在翻译文本时，提供足够的上下文信息对于翻译者非常重要。这可以通过提供详细的注释、上下文示例或者与翻译者的沟通来实现。这样可以确保翻译文本的准确性和一致性。
-
定期更新翻译：随着插件的演进和功能增加，新的文本可能会添加到插件中。确保及时更新翻译文件，以便提供最新的翻译文本。
-
测试本地化：在开发插件时，测试本地化是至关重要的。确保在不同语言环境下测试插件的界面，以验证翻译文本的正确性和适应性。
通过遵循上述技巧和注意点，你可以有效地进行插件本地化，为不同语言环境的用户提供更好的用户体验，并扩大插件的用户群体。
PropertiesComponent 和 ResourceBundle 加载本地化文本 有什么区别？建议使用哪一个
PropertiesComponent 和 ResourceBundle 都可以用于加载本地化文本，但它们在实现和使用上有一些区别。下面是它们的主要区别以及建议的使用情况：
- 实现方式：
PropertiesComponent是 IntelliJ IDEA 平台提供的一个类，用于处理插件的持久化配置。它允许你存储和读取键值对形式的配置信息，包括本地化文本。你可以使用PropertiesComponent来存储和获取本地化文本，但它主要用于存储插件的配置信息。ResourceBundle是 Java 标准库中的一个类，用于加载本地化资源文件。它基于属性文件（.properties）来存储本地化文本，每个语言对应一个属性文件。你可以使用ResourceBundle来加载和访问本地化文本。
- 文件格式：
PropertiesComponent使用基于 XML 格式的文件来存储配置信息，而不是传统的 .properties 文件格式。ResourceBundle使用标准的 .properties 文件格式来存储本地化文本。
- 使用场景：
PropertiesComponent适合于存储插件的配置信息，包括用户自定义的设置和状态。它提供了方便的 API 来读取和写入配置值，并自动处理持久化。ResourceBundle适合于加载本地化文本，特别是在需要多语言支持的场景下。它可以根据当前的语言环境加载相应的属性文件，并提供简单的 API 来获取本地化文本。
综上所述，如果你需要存储插件的配置信息，并且需要处理持久化和用户自定义设置，那么建议使用 PropertiesComponent。如果你只需要加载本地化文本，而不涉及插件配置的存储和读取，那么建议使用 ResourceBundle。
需要注意的是，PropertiesComponent 是 IntelliJ IDEA 平台特定的类，而 ResourceBundle 是 Java 标准库中的类，可以在不同的 Java 应用程序中使用。因此，如果你的插件需要在不同的 IDE 或其他 Java 应用程序中使用，使用 ResourceBundle 可能更具通用性。
应用程序包布局
关于本地化目的，所有需要翻译的资源（英文）都位于名为 resources_en.jar 的 jar 文件中。
IDEA 核心功能有一个这样的 jar 文件位于 INSTALL_HOME\lib\resources_en.jar，每个捆绑插件都有一个 jar 文件位于 INSTALL_HOME\plugins$Plugin$\lib\resources_en.jar。
翻译后的资源应该被压缩并完全放在原始 jar 来自的同一文件夹中。
因此，本地化包应该具有完全相同数量的 jar 文件，并且它们的布局方式必须与原始 jar 的布局方式完全相同。
为了在每个安装中启用多个本地化而不让本地化包相互覆盖，我们建议在 jar 名称中包含语言环境的名称（例如，resources_ja.jar）。
resources_en.jar 的内容和布局
属性文件通常包含消息、菜单项、对话框标签文本等。
对于每个这样的文件，本地化的 jar 应该包含翻译版本，该版本被放置在相对于 jar 根目录完全相同的路径中，并且具有与原始文件完全相同的名称加上区域设置标识符。
例如，来自 resources_en.jar 的 messages/ActionsBundle.properties 文件应该在 resources_ja.jar 中有其翻译版本的 messages/ActionsBundle_ja.properties 文件。
所有属性文件都应使用 \uXXXX 序列进行 ASCII 编码，这些序列用于在 ASCII 范围内没有表示的字符。 有关详细信息，请参阅 native2ascii 工具。
属性值主要遵循 MessageFormat 规则。
组件位置
| 检查描述出现在设置 | 错误中，并代表有关每个检查工具打算做什么的简短信息。 |
每个描述都由 /inspectionDescriptions/ 文件夹下的单个 html 文件表示，该文件应以 UTF-8 编码进行编码。
本地化版本应存储在以 locale 为后缀的文件夹中。
例如从resources_en.jar翻译的/inspectionDescriptions/CanBeFinal.html应该放在resources_ja.jar中的/inspectionDescriptions_ja/CanBeFinal.html。
意向描述和样品与检验描述非常相似，但布局更高级一些。
每个意图都有一堆文件位于 /intentionDescriptions/ 中以意图的简称命名的文件夹中。
这些文件包括 description.html，其中包含类似于检查一的描述以及几个模板文件，用于演示意图将对样本执行的操作。
这些模板是可选的翻译。
与检查描述类似，整个 intentionDescriptions 文件夹应以区域设置标识符为后缀。
例如 /intentionDescriptions/AddOnDemandStaticImportAction/description.html 翻译应该放在 /intentionDescriptions_ja/AddOnDemandStaticImportAction/description.html 中。 所有 HTML 文件都应采用 UTF-8 编码。
当天的提示遵循相同的模式检查和意图。
例如，/tips/AdaptiveWelcome.html 的翻译转到 /tips_ja/AdaptiveWelcome.html。
提示的唯一特别之处在于它们使用特殊模式来表示 EnterAction 等快捷方式；
在运行时将替换为映射到当前使用的键盘映射中的 EnterAction 的击键。
因此，请确保在翻译时完整保留这些序列。
记住 UTF-8 编码。
文件模板再次采用相同的方式（如果需要翻译的话）。
/fileTemplates/Singleton.java.ft 转到 /fileTemplates_ja/Singleton.java.ft。
遵循 Sun 的属性包规则，只要在本地化版本中找不到某些资源，就会使用 resources_en.jar 中的默认版本。
参考资料
https://plugins.jetbrains.com/docs/intellij/localization-guide.html
https://blog.csdn.net/HaHa_Sir/article/details/122851700
- idea 中 properties 文件打开强制为 iso-8859-1 编码打开，如何修改为 utf-8
- java 中如何使用 ResourceBundle 读取 i18n 配置
- properties 中文内容发现打包之后乱码 如何解决？
- i18n 语言国际化中，创建资源包（Resource Bundle） 文件夹的位置和名字？
- 介绍一下 idea 插件的 Localization 语言国际化
- PropertiesComponent 和 ResourceBundle 加载本地化文本 有什么区别？建议使用哪一个
- 应用程序包布局
- resources_en.jar 的内容和布局
- 组件位置
- 参考资料
更多学习
更多实时资讯，前沿技术，生活趣事。尽在【老马啸西风】
交流社群：[交流群信息](https://mp.weixin.qq.com/s/rkSvXxiiLGjl3S-ZOZCr0Q)
