本文介绍一种健壮、可扩展的方法：通过二进制模式读取 UTF-8 文件，配合 codecs.IncrementalDecoder 手动解码，实时记录每个有效字符（及解码错误段）在原始文件中的起始与结束字节位置，兼顾容错性与教学场景下的“尽力而为”需求。

本文介绍一种健壮、可扩展的方法：通过二进制模式读取 utf-8 文件，配合 `codecs.incrementaldecoder` 手动解码，实时记录每个有效字符（及解码错误段）在原始文件中的起始与结束字节位置，兼顾容错性与教学场景下的“尽力而为”需求。

在处理来自不可信来源（如学生提交的代码生成文件）的文本时，仅依赖 open(..., encoding='utf-8') 会因非法字节序列直接抛出 UnicodeDecodeError，导致信息丢失且无法定位问题位置。而简单地用 char.encode('utf-8') 反推偏移又无法应对解码错误、BOM、混合编码或流式截断等现实情况。真正的解决方案是绕过高层文本接口，回归字节层控制解码过程——即以二进制模式打开文件，使用增量解码器（IncrementalDecoder）逐字节喂入数据，并结合 file.tell() 精确捕获每个成功产出字符所对应的原始字节范围。

以下是一个生产就绪的参考实现，已针对常见边界条件（如不完整多字节序列、孤立续字节、空文件、EOF）进行加固：

import codecs
from typing import List, Tuple, Union

def iter_char_offsets(
    file_path: str,
    encoding: str = 'utf-8',
    errors: str = 'replace'  # 或 'ignore', 'strict'
) -> List[Tuple[Union[str, None], int, int]]:
    """
    逐字符迭代文件内容，返回 (字符/None, 起始字节偏移, 结束字节偏移) 元组列表。
    遇到解码错误时，将错误字节段标记为 (None, start, end)，字符字段为 None。
    """
    decoder = codecs.getincrementaldecoder(encoding)(errors=errors)
    result = []

    with open(file_path, 'rb') as f:
        start = 0
        while True:
            byte = f.read(1)
            if not byte:
                # EOF reached; flush any remaining state
                try:
                    leftover = decoder.decode(b'', final=True)
                    if leftover:
                        end = f.tell() - 1
                        result.append((leftover, start, end))
                except UnicodeDecodeError:
                    end = f.tell() - 1
                    result.append((None, start, end))
                break

            current_pos = f.tell()
            try:
                char = decoder.decode(byte, final=False)
                if char:  # 解码完成一个字符
                    end = current_pos - 1
                    result.append((char, start, end))
                    start = current_pos
                # 否则继续累积字节，不更新 start
            except UnicodeDecodeError as e:
                # 处理解码失败：记录错误区间，重置解码器，从当前字节重新开始
                end = current_pos - 1
                result.append((None, start, end))
                decoder.reset()
                start = current_pos  # 下次从当前字节开始
                # 注意：此处未将出错字节喂给 decoder，避免状态污染

    return result

# 使用示例
if __name__ == '__main__':
    # 生成含故意损坏 UTF-8 的测试文件（同原答案逻辑）
    test_data = (
        'A'.encode('utf-8') +
        'ü'.encode('utf-8') +
        b'\r\n' +
        '我'.encode('utf-8') +
        b'\xF0\x9F' +  # 截断的 4 字节 emoji
        '是'.encode('utf-8') +
        b'\x9F' +       # 孤立续字节
        b'\xF0'         # 孤立首字节
    )
    with open('test_corrupt.txt', 'wb') as f:
        f.write(test_data)

    for char, start, end in iter_char_offsets('test_corrupt.txt'):
        if char is None:
            print(f"[ERROR] bytes {start:02x}h–{end:02x}h")
        else:
            print(f"'{char}' U+{ord(char):04X}: bytes {start:02x}h–{end:02x}h")

关键设计说明：

Secure Python Code Sandbox

安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。

下载

• ✅ 容错优先：采用 errors='replace'（默认）策略，解码器内部会用 `替换非法序列，但本实现选择显式暴露错误区间（返回None），便于上层做高亮、报告或跳过处理；若需静默修复，可改用errors='replace'并提取decoder.decode(...)` 的实际输出。
• ✅ 状态隔离：每次解码失败后调用 decoder.reset()，彻底清除内部缓冲，确保后续解码不受污染——这是手动解码的核心安全实践。
• ✅ 字节精度：f.tell() 在二进制模式下始终返回确切字节偏移，start/end 均为闭区间（inclusive），可直接用于 f.seek(start); f.read(end - start + 1) 验证。
• ⚠️ 注意事项：
  • 不支持 BOM 自动识别（需提前剥离）；若需处理，可在 open(..., 'rb') 后先读取并跳过 b'\xef\xbb\xbf'。
  • 对超大文件，建议配合 yield 改为生成器版本以节省内存。
  • 若需支持其他编码（如 gbk, latin-1），只需传入对应 encoding 参数，IncrementalDecoder 会自动适配。

此方法将“字符语义”与“字节物理位置”的映射权完全交还开发者，既满足 diff 工具对精准定位的需求，又为教育场景提供了透明、可控、可调试的错误处理路径——不再黑盒，只留清晰。

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