Java Locale getDisplayCountry 怎样按指定语言显示地区名称
Java 的 Locale.getDisplayCountry(Locale) 解决的是“把一个地区代码显示成用户看得懂的地区名称”。关键在于分清两个 Locale:调用对象代表被显示的地区,参数 inLocale 代表名称使用的语言。例如,en-US 是美国这个地区,传入中文显示 Locale 后才会得到中文地区名称。
要按指定语言显示地区名称,使用 sourceLocale.getDisplayCountry(displayLocale),不要把显示语言混在地区 Locale 本身里;无参重载依赖 JVM 的 DISPLAY 默认 Locale。
官方文档:https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/Locale.html#getDisplayCountry(java.util.Locale)
先分清“地区是谁”和“用什么语言显示”
Locale 可以同时包含 language、script、country 等字段。getDisplayCountry 只读取调用对象里的 country,再按照传入的 inLocale 选择地区名称的表达语言。也就是说,Locale.forLanguageTag("en-US") 的 US 是被显示的地区,而不是要求结果一定用英文显示。
import java.util.Locale;
public class DisplayCountryDemo {
public static void main(String[] args) {
// sourceLocale 表示要显示的地区,US 是地区代码。
Locale sourceLocale = Locale.forLanguageTag("en-US");
// displayLocale 只控制地区名称使用哪种语言。
Locale displayLocale = Locale.SIMPLIFIED_CHINESE;
String countryName = sourceLocale.getDisplayCountry(displayLocale);
System.out.println(countryName);
}
}
这段写法的重点不是把两个对象都设成中文,而是保留 sourceLocale 的地区信息,再单独指定 displayLocale。在常见 Java 运行时中,输出会是中文的“美国”一类地区名称;具体文字属于运行时 Locale 数据,不能把它当成固定的业务编码。

显式传入 inLocale,避免服务器默认语言影响结果
如果接口、报表或地区选择器要固定显示语言,优先使用带参数的重载。下面让同一个美国地区分别用中文、英文和日文表达:
import java.util.Locale;
public class DisplayCountryLanguages {
public static void main(String[] args) {
// 被显示的地区始终是美国,结果语言由第二个参数决定。
Locale region = Locale.forLanguageTag("en-US");
Locale[] displayLocales = {
Locale.SIMPLIFIED_CHINESE,
Locale.ENGLISH,
Locale.JAPANESE
};
for (Locale displayLocale : displayLocales) {
// 显式传入显示 Locale,避免依赖机器的默认 DISPLAY 设置。
System.out.println(region.getDisplayCountry(displayLocale));
}
}
}
| 调用方式 | 真正控制的内容 | 适合场景 |
|---|---|---|
region.getDisplayCountry(Locale.SIMPLIFIED_CHINESE) | 固定使用简体中文显示 | 接口返回、导出报表、可重复测试 |
region.getDisplayCountry(Locale.ENGLISH) | 固定使用英文显示 | 英文后台或跨语言日志 |
region.getDisplayCountry() | 使用 DISPLAY 类别默认 Locale | 跟随用户或运行环境的交互界面 |
无参版本并不是“自动识别最合适的语言”,它使用当前默认的 DISPLAY Locale。部署环境、启动参数或应用代码改变默认值后,同一段代码的展示结果就可能改变;需要稳定输出时,把 inLocale 作为调用方的明确依赖传入。
空地区、默认 Locale 和回退行为怎么判断
这个 API 有三个容易混淆的边界。第一,调用对象没有 country 字段时,返回空字符串,不会凭语言字段猜一个地区。第二,如果目标显示语言没有可用的本地化名称,Java 会尝试回退到英文名称,最后才使用 ISO 地区代码。第三,inLocale 不能传 null,否则会抛出 NullPointerException。
import java.util.Locale;
public class DisplayCountryBoundaries {
public static void main(String[] args) {
// 只有语言,没有 country;getDisplayCountry 不会推断地区。
Locale languageOnly = Locale.forLanguageTag("en");
String emptyCountry = languageOnly.getDisplayCountry(Locale.SIMPLIFIED_CHINESE);
System.out.println(emptyCountry); // 预期为空字符串
// 不传参数时,名称语言来自 DISPLAY 类别的默认 Locale。
Locale region = Locale.forLanguageTag("fr-FR");
String environmentDependent = region.getDisplayCountry();
System.out.println(environmentDependent);
}
}
因此,业务代码不要用“返回空字符串”去表示“地区未知”和“地区名称尚未翻译”这两种不同状态。前者是输入 Locale 没有 country,后者才涉及显示数据的回退;如果要在界面上区分它们,应该先检查 getCountry() 是否为空,再决定展示占位文本。

工程代码怎样写得更稳定
如果地区来自用户输入或接口字段,可以把“解析地区”和“选择显示语言”放在一个小方法中。这样调用方不必依赖 JVM 默认 Locale,也能在输入没有地区时提前决定产品策略:
import java.util.Locale;
import java.util.Objects;
public final class CountryNames {
private CountryNames() {
// 工具类不需要被实例化。
}
public static String displayCountry(String languageTag, Locale displayLocale) {
// 显示语言是调用约束,显式拒绝 null,避免在更深层才出现 NPE。
Objects.requireNonNull(displayLocale, "displayLocale");
Locale sourceLocale = Locale.forLanguageTag(languageTag);
// 没有地区代码时交给上层决定占位文案,不把语言误当成地区。
if (sourceLocale.getCountry().isEmpty()) {
return "";
}
return sourceLocale.getDisplayCountry(displayLocale);
}
}
这个封装保留了 Java API 的语义:地区由输入标签中的 country 决定,名称语言由 displayLocale 决定。若产品需要“未知地区”文案,可以在方法外把空字符串映射为业务提示;若需要固定语言,则从请求上下文明确传入对应 Locale,而不是修改全局默认值。
常见问题
为什么 getDisplayCountry() 在本地和服务器上结果不同? 因为无参重载使用 DISPLAY 类别默认 Locale。把目标显示语言显式传入,就不会把展示结果交给部署环境决定。
为什么只有 Locale.ENGLISH 却拿不到国家名称? 因为它只有 language 字段,没有 country。getDisplayCountry 不会根据语言自动推断地区,所以返回空字符串是符合 API 语义的结果。
应该用 getDisplayName 代替吗? 如果只想展示地区,就用 getDisplayCountry;getDisplayName 会把语言、脚本、地区和变体组合成更完整的 Locale 名称,输出范围更大。
小结
- 调用对象的 Locale 决定“哪个地区”,
inLocale决定“用什么语言命名”。 - 固定语言的接口、报表和测试应使用
getDisplayCountry(displayLocale)。 - 没有 country 时返回空字符串,名称无法本地化时按英文和 ISO 代码回退,
null显示 Locale 会抛出NullPointerException。
Java 25 Compact Source Files 怎样减少小程序样板代码
- 上一篇
- Java 25 Compact Source Files 怎样减少小程序样板代码
- 下一篇
- Java Currency getNumericCodeAsString 怎样保留货币编号前导零
-
- 文章 · java教程 | 31分钟前 | Java教程 · java 小程序 Java 25 Compact Source Files main 方法
- Java 25 Compact Source Files 怎样减少小程序样板代码
- 131浏览 收藏
-
- 文章 · java教程 | 39分钟前 | Java教程 · java Switch instanceof 装箱 Java 25 Primitive Types in Patterns
- Java 25 Primitive Types in Patterns 怎样避免模式匹配中的装箱误判
- 465浏览 收藏
-
- 文章 · java教程 | 18小时前 | 并发编程 · Java教程 · java 结构化并发 ScopedValue ScopedValue.where 动态作用域
- Java ScopedValue.where 怎样在调用范围内绑定值
- 447浏览 收藏
-
- 文章 · java教程 | 18小时前 |
- Java ClassFile.build 怎样生成可写入磁盘的最小 class 文件
- 283浏览 收藏
-
- 文章 · java教程 | 18小时前 |
- Java MethodHandles.guardWithTest 怎样按条件选择方法句柄
- 119浏览 收藏
-
- 文章 · java教程 | 18小时前 | Java · java skip reset mark StringReader
- Java StringReader.skip 怎样向前回退字符位置
- 160浏览 收藏
-
- 文章 · java教程 | 18小时前 |
- Java Optional.or 怎样延迟提供备用 Optional
- 412浏览 收藏
-
- 文章 · java教程 | 18小时前 | Java · Stream · java Stream Gatherers windowSliding
- Java Gatherers.windowSliding 怎样生成重叠窗口
- 192浏览 收藏
-
- 文章 · java教程 | 18小时前 | Java · java Inflater getRemaining
- Java Inflater.getRemaining 怎样找回压缩数据后的尾部字节
- 309浏览 收藏
-
- 文章 · java教程 | 19小时前 | Java · HTTP · java HTTP客户端 httpclient 请求超时 HttpRequest.Builder.timeout
- Java HttpRequest.Builder.timeout 怎样设置请求级超时
- 300浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1141次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1126次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1303次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1242次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1093次使用
-
- Go x/text/secure/precis UsernameCaseMapped 怎样规范账户名
- 2026-10-27 390浏览
-
- Go x/text/unicode/bidi Paragraph 怎样读取混合方向文本段落
- 2026-10-27 122浏览
-
- Go go-i18n 找不到目标语言消息时怎样回退
- 2026-10-30 368浏览
-
- PHP IntlDateFormatter 如何避免时区漂移:locale、timezone 与格式化结果核对
- 2026-08-29 260浏览
-
- PHP 金额格式化时怎样指定货币和区域
- 2026-10-18 216浏览

