一、什么是“國(guó)際化”（i18n）？

• 讓同一個(gè)應(yīng)用能 自動(dòng)顯示不同語(yǔ)言的內(nèi)容。
• 比如：
  • 用戶(hù)瀏覽器語(yǔ)言是 zh-CN（簡(jiǎn)體中文）→ 顯示“歡迎”
  • 用戶(hù)語(yǔ)言是 en-US（美式英語(yǔ)）→ 顯示“Welcome”

Spring Boot 通過(guò) MessageSource 接口實(shí)現(xiàn)這一功能，而它默認(rèn)使用 資源文件（properties 文件） 來(lái)存儲(chǔ)不同語(yǔ)言的消息。

二、默認(rèn)行為：自動(dòng)配置 MessageSource

自動(dòng)生效的條件：

Spring Boot 只有在 classpath 根目錄下找到 messages.properties 文件時(shí)，才會(huì)自動(dòng)配置 MessageSource。

也就是說(shuō)：

• 如果你有 messages.properties（這是默認(rèn)語(yǔ)言，通常是英文或中性語(yǔ)言），Spring Boot 會(huì)自動(dòng)啟用國(guó)際化支持。
• 如果你只有 messages_zh.properties 或 messages_fr.properties，但沒(méi)有 messages.properties，那么 Spring Boot 不會(huì)自動(dòng)配置 MessageSource！

所以：必須提供一個(gè)默認(rèn)的 messages.properties，即使它是空的！

三、如何自定義資源包位置？

你可以通過(guò) application.properties 或 application.yml 修改默認(rèn)設(shè)置：

# 指定多個(gè)資源文件基名（basename），用逗號(hào)分隔
spring.messages.basename=messages,config.i18n.messages

# 是否回退到系統(tǒng)本地語(yǔ)言（默認(rèn) true）
spring.messages.fallback-to-system-locale=false

解釋?zhuān)?/h3>

spring.messages.basename=messages,config.i18n.messages

• 表示 Spring 會(huì)去加載兩類(lèi)資源文件：
  1. messages.properties、messages_zh_CN.properties 等
  2. config/i18n/messages.properties、config/i18n/messages_en.properties 等
• 路徑可以是：
  • 類(lèi)路徑根目錄下的文件（如 messages.properties）
  • 包路徑形式（如 config.i18n.messages → 對(duì)應(yīng) classpath:config/i18n/messages.properties）

spring.messages.fallback-to-system-locale=false

• 默認(rèn)為 true：如果用戶(hù) locale 是 zh-CN，但找不到 messages_zh_CN.properties，就會(huì)嘗試 messages_zh.properties → 再找不到就用系統(tǒng)默認(rèn) locale（比如服務(wù)器操作系統(tǒng)的語(yǔ)言）。
• 設(shè)為 false：找不到精確匹配就直接用 messages.properties（不回退到系統(tǒng) locale）。

四、資源文件命名規(guī)則

假設(shè)你的 basename 是 messages，那么 Spring 會(huì)按以下優(yōu)先級(jí)查找：

注意：messages.properties 是兜底文件，必須存在，否則整個(gè)國(guó)際化機(jī)制不會(huì)啟動(dòng)！

五、代碼中如何使用？

在 Controller 或 Service 中注入 MessageSource：

@Autowired
private MessageSource messageSource;

@GetMapping("/greet")
public String greet(Locale locale) {
    return messageSource.getMessage("greeting", null, locale);
}

對(duì)應(yīng)的 messages.properties：

greeting=Hello!

messages_zh.properties：

greeting=你好！

當(dāng)請(qǐng)求帶 Accept-Language: zh 時(shí)，返回“你好！”；否則返回“Hello!”。

總結(jié)關(guān)鍵點(diǎn)

建議實(shí)踐

1. 在 src/main/resources/ 下創(chuàng)建：
   • messages.properties（默認(rèn)英文）
   • messages_zh.properties（中文）

在 application.yml 中明確配置（可選但推薦）：

spring:
  messages:
    basename: messages
    fallback-to-system-locale: false

1. 在代碼中通過(guò) MessageSource 獲取本地化消息。

這樣你的 Spring Boot 應(yīng)用就具備了多語(yǔ)言能力！

到此這篇關(guān)于SpringBoot支持國(guó)際化的配置方法的文章就介紹到這了,更多相關(guān)SpringBoot支持國(guó)際化內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論