本文旨在提供一个清晰简洁的 Python 函数，用于根据国家名称在 countries.json 文件中查找并返回其对应的 2 位和 3 位 ISO 国家代码。我们将详细介绍代码实现，并针对可能出现的问题提供排查思路和解决方案，确保读者能够顺利地使用该函数。
函数定义与实现
以下 Python 函数 lookup_country_iso_codes 实现了根据国家名称查找其 2 位和 3 位 ISO 代码的功能。它读取名为 countries.json 的文件，遍历其中的国家数据，并在找到匹配项时返回相应的 ISO 代码。
import json
def lookup_country_iso_codes(country: str) -> tuple:
# Load the JSON file
with open('countries.json') as file:
countries = json.load(file)
# Iterate through countries and match the specified country name
for c in countries:
if c['name'] == country:
# Return 2-digit and 3-digit ISO codes when a match is found
return c['iso2'], c['iso3']
# If the country is not found, return None for both values
return None, None代码解释：
- 导入 json 模块： 用于读取 JSON 文件。
- 定义函数 lookup_country_iso_codes： 接受一个字符串参数 country，表示要查找的国家名称，并返回一个元组，包含 2 位和 3 位 ISO 代码。
- 打开并读取 countries.json 文件： 使用 with open() 语句确保文件在使用完毕后自动关闭。 json.load(file) 将 JSON 文件内容加载到 countries 变量中，countries 变量将是一个 Python 列表，列表中的每一个元素都是一个字典，代表一个国家的信息。
- 遍历国家数据： 使用 for 循环遍历 countries 列表中的每个国家。
- 查找匹配的国家名称： 使用 if c['name'] == country: 比较当前国家的名称和输入参数 country。
- 返回 ISO 代码： 如果找到匹配项，则返回该国家的 iso2 和 iso3 字段的值。
- 处理未找到的情况： 如果遍历完所有国家后仍未找到匹配项，则返回 (None, None)。
使用示例
以下代码展示了如何使用 lookup_country_iso_codes 函数：
立即学习“Python免费学习笔记（深入）”；
# Example usage of the function
print(lookup_country_iso_codes("Taiwan"))
print(lookup_country_iso_codes("Japan"))输出：
('TW', 'TWN')
('JP', 'JPN')注意事项与问题排查
在使用该函数时，需要注意以下几点，并针对可能出现的问题进行排查：
- countries.json 文件路径： 确保 countries.json 文件位于脚本的同一目录下，或者提供正确的绝对或相对路径。
- 国家名称匹配： 函数区分大小写，并且需要精确匹配国家名称。确保 countries.json 文件中的国家名称与你传入的 country 参数完全一致。 建议在匹配前，将国家名称统一转换为小写，以避免大小写带来的问题。
- countries.json 文件内容： 确保 countries.json 文件包含正确的 JSON 格式数据，并且每个国家对象都包含 name、iso2 和 iso3 字段。
- 编码问题： 确保 countries.json 文件使用 UTF-8 编码，以避免读取包含特殊字符的国家名称时出现问题。读取文件时，可以指定编码方式，例如：with open('countries.json', 'r', encoding='utf-8') as file:。
- AssertionError 错误： 如果出现 AssertionError: Tuples differ: (None, None) != ('TW', 'TWN') 错误，通常表示函数未能找到指定的国家，返回了 (None, None)，导致断言失败。 检查上述几点，确保国家名称匹配、文件路径正确、文件内容格式正确。
总结
lookup_country_iso_codes 函数提供了一种简单有效的方法，用于根据国家名称查找其 ISO 代码。通过理解代码实现、掌握使用示例和注意潜在问题，你可以轻松地将此函数应用到你的项目中。在实际使用中，请务必注意数据源的准确性和一致性，并根据需要进行适当的错误处理。
