Python从外部文本文件向目标文件插入内容的问题排查与解决

contents.insert(2, contentsg)这行代码将calinks.txt读取到的整个列表作为单个元素插入到sample.txt的行列表中，导致contents列表里同时存在字符串（原文件的行）和列表（插入的内容）。而str.join()方法要求传入的序列所有元素必须是字符串类型，因此触发TypeError。

# 读取sample.txt的所有行
with open("sample.txt", "r") as f:
    contents = f.readlines()

# 读取calinks.txt的所有行
with open("calinks.txt", "r") as g:
    contentsg = g.readlines()

# 把calinks的内容逐行插入到sample.txt的第3行前（索引为2的位置）
contents[2:2] = contentsg

# 将修改后的内容写回sample.txt
with open("sample.txt", "w") as f:
    f.writelines(contents)

关键改动说明 #

用切片赋值contents[2:2] = contentsg替代insert方法，它会把contentsg中的每一行字符串依次插入到contents的指定位置，保证contents列表全为字符串元素，后续使用writelines直接写入更高效（无需额外拼接字符串）。

可以封装成通用函数，方便后续在其他文件操作中复用：

def insert_file_to_target(target_file, insert_index, source_file, encoding="utf-8"):
    # 读取目标文件内容
    with open(target_file, "r", encoding=encoding) as f:
        target_lines = f.readlines()
    
    # 读取源文件内容
    with open(source_file, "r", encoding=encoding) as g:
        source_lines = g.readlines()
    
    # 校验插入位置合法性
    if not 0 <= insert_index <= len(target_lines):
        raise ValueError(f"插入位置必须在0到{len(target_lines)}之间")
    
    # 执行插入操作
    target_lines[insert_index:insert_index] = source_lines
    
    # 写入修改后的内容
    with open(target_file, "w", encoding=encoding) as f:
        f.writelines(target_lines)

# 使用示例：把calinks.txt内容插入到sample.txt的第3行前（索引2）
insert_file_to_target("sample.txt", 2, "calinks.txt")

函数优势 #

• 支持指定编码，避免中文乱码问题
• 增加插入位置合法性校验，防止越界错误
• 参数化设计，可快速适配不同文件的插入需求

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