Python读取含特殊字符的MTG卡牌文件失败，无法修改数据库文件名如何解决？

问题根因 #

• Unicode等价性冲突：带变音符号的特殊字符（如你案例中的Ã）存在两种Unicode编码表示：预合成形式（单个Unicode码位）和分解形式（基础字符+组合变音符号），视觉上完全一致但编码值不同，导致生成的路径和实际存储的文件名不匹配。
• OpenCV cv2.imread 原生缺陷：该函数底层依赖C++标准库的文件读取接口，在Windows环境下默认不支持UTF-8编码的路径，只要路径包含非ASCII字符就会读取失败，哪怕路径完全正确。
• 文件名转义逻辑不匹配：你调用的fetch_data.get_valid_filename可能对特殊字符的转义规则和你实际存储文件时的规则不一致，导致生成的文件名和本地存储的名称对不上。

修复步骤 #

1. 先验证文件名匹配逻辑 #

先加调试代码，对比生成的文件名和实际文件名的差异：

# 加在生成img_name之后
expected_name_part = fetch_data.get_valid_filename(card_info['name'])
print(f"生成的卡牌名部分：{expected_name_part}, 实际文件名对应部分：JÃtun_Grunt")
print(f"两者是否相等：{expected_name_part == 'JÃtun_Grunt'}")

如果输出不相等，说明是get_valid_filename的转义逻辑问题，你要么修改该函数的规则，要么下载文件的时候统一用该函数处理后的结果命名，保证两边一致。

2. 统一Unicode规范化形式 #

用Python标准库unicodedata把所有涉及文件名的字符串统一为同一种规范化形式，避免编码表示差异：

import unicodedata

# 处理卡牌名的时候统一转成NFC规范化形式
normalized_name = unicodedata.normalize('NFC', card_info['name'])
processed_name = fetch_data.get_valid_filename(normalized_name)

下载文件存储的时候，也要用同样的规范化逻辑处理文件名，保证存储和读取的名称规则统一。

3. 替换OpenCV的文件读取方式，绕过编码缺陷 #

不要直接传路径给cv2.imread，改成先读取文件字节流再解码的方式，适配所有编码的路径：

import numpy as np

# 原来的card_img = cv2.imread(img_name)替换成下面的代码
if os.path.exists(img_name):
    with open(img_name, 'rb') as f:
        img_bytes = f.read()
    card_img = cv2.imdecode(np.frombuffer(img_bytes, np.uint8), cv2.IMREAD_COLOR)
else:
    card_img = None

这种方式完全绕过了OpenCV的路径解析逻辑，只要Python能识别到文件路径，就能正常读取。

4. 下载文件时的兼容处理 #

如果触发了下载逻辑，存储文件的时候也要用同样的规范化、转义规则处理文件名，避免下载的文件名称和后续读取的规则不匹配。

修改后完整代码示例 #

import unicodedata
import numpy as np
import os

for card_name in card_names:
    card_info['name'] = card_name
    # 统一Unicode规范化
    normalized_name = unicodedata.normalize('NFC', card_info['name'])
    processed_name = fetch_data.get_valid_filename(normalized_name)
    img_name = '%s/card_img/png/%s/%s_%s.png' % (Config.data_dir, card_info['set'],
                                                 card_info['collector_number'],
                                                 processed_name)
    # 用字节流方式读取图片
    if os.path.exists(img_name):
        with open(img_name, 'rb') as f:
            img_bytes = f.read()
        card_img = cv2.imdecode(np.frombuffer(img_bytes, np.uint8), cv2.IMREAD_COLOR)
    else:
        card_img = None

    # 如果图片不存在，下载
    if card_img is None:
        fetch_data.fetch_card_image(card_info,
                                    out_dir='%s/card_img/png/%s' % (Config.data_dir, card_info['set']))
        # 下载后重新读取
        if os.path.exists(img_name):
            with open(img_name, 'rb') as f:
                img_bytes = f.read()
            card_img = cv2.imdecode(np.frombuffer(img_bytes, np.uint8), cv2.IMREAD_COLOR)
        else:
            card_img = None
    if card_img is None:
        print('WARNING: card %s is not found!' % img_name)

内容的提问来源于stack exchange，提问作者iac009