Python 中文繁简体转换工具 openccpy 使用指南

方法详解

转为简体

def to_simple(traditional):
    """
    繁体转化为简体
    1. 如果字符为空，直接返回
    2. 字符长度为 1，返回对应简体字符
    3. 对应长度大于 1，返回对应简体词组
    :param traditional: 繁体单词/单个词组
    :return: 对应的简体信息
    """
    # 内部实现逻辑由 OpenCC 引擎处理
    pass

转为繁体

def to_traditional(simple):
    """
    简体转化为繁体
    1. 如果字符为空，直接返回
    2. 字符长度为 1，返回对应繁体字符
    3. 对应长度大于 1，返回对应繁体词组
    :param simple: 简体单词/单个词组
    :return: 对应的繁体信息
    """
    # 内部实现逻辑由 OpenCC 引擎处理
    pass

高级用法

自定义转换器

对于更复杂的场景，可以实例化 Converter 对象来指定具体的转换方案（如传统台湾、大陆简体等）。

from openccpy.opencc import Converter

# 创建转换器实例
converter = Converter('t2s')  # 繁体到简体

text = "這是一個測試"
result = converter.convert(text)
print(result)  # 输出：这是一个测试

文件批量转换

在实际应用中，经常需要对整个文件进行繁简转换。以下示例演示如何读取文件并保存转换后的结果。

import codecs

def convert_file(input_path, output_path, mode='t2s'):
    """
    批量转换文件内容
    :param input_path: 输入文件路径
    :param output_path: 输出文件路径
    :param mode: 转换模式 ('t2s' 或 's2t')
    """
    converter = Converter(mode)
    
    try:
        # 使用 utf-8-sig 编码处理可能存在的 BOM
        with codecs.open(input_path, 'r', encoding='utf-8') as f_in:
            content = f_in.read()
        
        converted_content = converter.convert(content)
        
        with codecs.open(output_path, 'w', encoding='utf-8') as f_out:
            f_out.write(converted_content)
            
        print(f"转换完成：{input_path} -> {output_path}")
        
    except FileNotFoundError:
        print(f"错误：找不到文件 {input_path}")
    except Exception as e:
        print(f"发生错误：{e}")

# 使用示例
# convert_file('input.txt', 'output.txt', 't2s')

常见问题与注意事项

1. 编码问题: 确保输入和输出文件使用统一的编码格式（推荐 UTF-8），避免乱码。
2. 性能优化: 对于大量文本处理，建议复用 Converter 实例，而不是每次转换都重新创建。
3. 特殊字符: 部分生僻字可能无法完全匹配，转换结果以 OpenCC 内置词典为准。
4. 依赖: openccpy 底层依赖 OpenCC 库，通常 pip 安装会自动处理相关依赖。

总结

openccpy 为 Python 项目提供了稳定可靠的中文繁简转换能力。通过简单的 API 调用即可实现文本的双向转换，配合文件处理示例，可轻松集成到自动化脚本或 Web 服务中。开发者可根据实际需求选择合适的转换模式，提升文本处理的效率。