本文旨在提供一个清晰且实用的指南，帮助读者使用 Python 编写函数来查找给定国家名称的 2 位和 3 位 ISO 国家代码。通过加载包含国家信息的 JSON 文件，并进行精确匹配，该函数能够准确地返回所需的 ISO 代码，并处理未找到国家的情况。
编写 lookup_country_iso_codes 函数
以下是如何使用 Python 实现 lookup_country_iso_codes 函数，该函数接受国家名称作为输入，并返回其对应的 2 位和 3 位 ISO 代码：
代码解释：
导入 json 模块：
这允许我们读取 countries.json 文件中的 JSON 数据。
定义 lookup_country_iso_codes 函数：
该函数接受一个字符串参数 country，表示要查找的国家名称。
打开并读取 JSON 文件：
使用 with open() 语句打开 countries.json 文件，并使用 json.load() 将其内容加载到名为 countries 的 Python 列表（列表中的每个元素都是一个字典，代表一个国家）。 encoding='utf-8' 用于确保正确处理包含非 ASCII 字符的文件。 使用 try...except 块处理文件不存在或JSON格式错误的情况。
循环遍历国家列表：
使用 for 循环遍历 countries 列表中的每个国家（字典）。
匹配国家名称：
对于每个国家，使用 if c['name'] == country: 检查其名称是否与输入的 country 参数匹配。
返回 ISO 代码：
如果找到匹配项，则返回一个包含 c['iso2'] (2 位 ISO 代码) 和 c['iso3'] (3 位 ISO 代码) 的元组。
处理未找到国家的情况：
如果循环完成而没有找到匹配项，则返回 (None, None)。
示例用法：
代码末尾提供了一些示例，演示如何使用该函数查找特定国家的 ISO 代码。
countries.json 文件格式
countries.json 文件应包含一个 JSON 数组，其中每个元素代表一个国家，并且至少包含 name、iso2 和 iso3 键。例如：
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
立即学习
“
Python免费学习笔记（深入）
”；
注意事项
文件路径：
确保 countries.json 文件位于脚本的同一目录下，或者提供文件的完整路径。
大小写敏感性：
国家名称匹配是区分大小写的。 如果需要不区分大小写的匹配，可以在比较之前将 country 和 c['name'] 都转换为小写。
数据准确性：
确保 countries.json 文件中的数据是准确和最新的。
错误处理：
包含 try...except 块以处理文件不存在或 JSON 格式错误的情况，从而提高代码的健壮性。
总结
通过这个教程，你已经学会了如何使用 Python 创建一个函数，根据国家名称查找其对应的 2 位和 3 位 ISO 代码。 这个函数对于需要处理国家信息的应用程序非常有用。 记住要验证 countries.json 文件的路径和内容，并考虑添加额外的错误处理以提高代码的可靠性。
import json
def lookup_country_iso_codes(country: str) -> tuple:
"""
根据国家名称，从 countries.json 文件中查找并返回 2 位和 3 位 ISO 国家代码。
如果未找到该国家，则返回 (None, None)。
Args:
country (str): 要查找的国家名称。
Returns:
tuple: 包含 2 位和 3 位 ISO 代码的元组。如果未找到国家，则返回 (None, None)。
"""
try:
with open('countries.json', 'r', encoding='utf-8') as file:
countries = json.load(file)
except FileNotFoundError:
print("错误：找不到 'countries.json' 文件。请确保该文件位于当前工作目录中。")
return None, None
except json.JSONDecodeError:
print("错误：'countries.json' 文件格式无效。请检查 JSON 格式是否正确。")
return None, None
for c in countries:
if c['name'] == country:
return c['iso2'], c['iso3']
return None, None
# 示例用法
print(lookup_country_iso_codes("Taiwan"))
print(lookup_country_iso_codes("Japan"))
print(lookup_country_iso_codes("United States"))
print(lookup_country_iso_codes("NonExistentCountry"))[
{
"name": "Afghanistan",
"iso2": "AF",
"iso3": "AFG",
"numeric": "004"
},
{
"name": "South Africa",
"iso2": "ZA",
"iso3": "ZAF",
"numeric": "710"
},
{
"name": "Åland Islands",
"iso2": "AX",
"iso3": "ALA",
"numeric": "248"
}
]