本文旨在提供一个清晰且实用的指南，帮助读者使用 Python 编写函数来查找给定国家名称的 2 位和 3 位 ISO 国家代码。通过加载包含国家信息的 JSON 文件，并进行精确匹配，该函数能够准确地返回所需的 ISO 代码，并处理未找到国家的情况。

编写 lookup_country_iso_codes 函数

以下是如何使用 Python 实现 lookup_country_iso_codes 函数，该函数接受国家名称作为输入，并返回其对应的 2 位和 3 位 ISO 代码：

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"))

代码解释：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

1. 导入 json 模块： 这允许我们读取 countries.json 文件中的 JSON 数据。
2. 定义 lookup_country_iso_codes 函数： 该函数接受一个字符串参数 country，表示要查找的国家名称。
3. 打开并读取 JSON 文件： 使用 with open() 语句打开 countries.json 文件，并使用 json.load() 将其内容加载到名为 countries 的 Python 列表（列表中的每个元素都是一个字典，代表一个国家）。 encoding='utf-8' 用于确保正确处理包含非 ASCII 字符的文件。 使用 try...except 块处理文件不存在或JSON格式错误的情况。
4. 循环遍历国家列表： 使用 for 循环遍历 countries 列表中的每个国家（字典）。
5. 匹配国家名称： 对于每个国家，使用 if c['name'] == country: 检查其名称是否与输入的 country 参数匹配。
6. 返回 ISO 代码： 如果找到匹配项，则返回一个包含 c['iso2'] (2 位 ISO 代码) 和 c['iso3'] (3 位 ISO 代码) 的元组。
7. 处理未找到国家的情况： 如果循环完成而没有找到匹配项，则返回 (None, None)。
8. 示例用法： 代码末尾提供了一些示例，演示如何使用该函数查找特定国家的 ISO 代码。

countries.json 文件格式

countries.json 文件应包含一个 JSON 数组，其中每个元素代表一个国家，并且至少包含 name、iso2 和 iso3 键。例如：

立即学习“Python免费学习笔记（深入）”；

[
  {
    "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"
  }
]

注意事项

• 文件路径： 确保 countries.json 文件位于脚本的同一目录下，或者提供文件的完整路径。
• 大小写敏感性： 国家名称匹配是区分大小写的。 如果需要不区分大小写的匹配，可以在比较之前将 country 和 c['name'] 都转换为小写。
• 数据准确性： 确保 countries.json 文件中的数据是准确和最新的。
• 错误处理： 包含 try...except 块以处理文件不存在或 JSON 格式错误的情况，从而提高代码的健壮性。

总结

通过这个教程，你已经学会了如何使用 Python 创建一个函数，根据国家名称查找其对应的 2 位和 3 位 ISO 代码。 这个函数对于需要处理国家信息的应用程序非常有用。 记住要验证 countries.json 文件的路径和内容，并考虑添加额外的错误处理以提高代码的可靠性。