如何解决Python自动打字脚本中for循环内的IndexError问题？

问题描述 #

使用Python一年多，编写过多个日常自动化脚本，近期开发的自动打字脚本可正常运行，但执行到末尾时抛出IndexError: list index out of range错误，怀疑问题出在str(sentence[lines],)这一行，询问应该使用len()还是if-else语句解决。

原脚本代码 #

import pyautogui as pt
from time import sleep

empty_file = "C:\\Users\\Lucas\\Desktop\\PycharmProjects\\Automate\\main\\screenshots\\empty_file.png"
text_write = "C:\\Users\\Lucas\\Desktop\\PycharmProjects\\Automate\\main\\text_write.txt"

with open(text_write, 'r') as f:
    text = f.read()
    sentence = text.split("\n")

position0 = pt.locateOnScreen(empty_file, confidence=.8)
x = position0[0]
y = position0[1]
pt.moveTo(x, y, duration=.05)
pt.leftClick()

def post_text():
    pt.moveTo(x-370, y+95, duration=.1)
    for lines in range(len(text)):
        pt.typewrite(str(sentence[lines],) + "\n", interval=.01)
        with pt.hold('shift'):
            pt.press('tab', presses=5)
        sleep(2)


post_text()

错误信息 #

C:\Users\Lucas\PycharmProjects\wechat_bot\venv\Scripts\python.exe C:/Users/Lucas/Desktop/PycharmProjects/Automate/main/auto_typer.py
Traceback (most recent call last):
  File "C:\Users\Lucas\Desktop\PycharmProjects\Automate\main\auto_typer.py", line 26, in <module>
    post_text()
  File "C:\Users\Lucas\Desktop\PycharmProjects\Automate\main\auto_typer.py", line 20, in post_text
    pt.typewrite(str(sentence[lines],) + "\n", interval=.01)
IndexError: list index out of range

Process finished with exit code 1

问题根源 #

错误的核心原因是循环范围错误：你用range(len(text))控制循环次数，但text是整个文本的字符总长度，而sentence是按换行分割后的行列表，两者长度完全不同。当循环变量lines超过sentence的实际行数时，就会触发索引越界。

另外，str(sentence[lines],)存在两个问题：

• 多了一个多余的逗号，属于语法错误；
• sentence中的元素本身就是字符串，不需要额外用str()转换。

解决方案 #

方式1：直接遍历sentence列表（推荐） #

最简洁且Pythonic的方式是直接遍历sentence列表，循环次数自动等于列表的行数，从根源避免越界问题：

def post_text():
    pt.moveTo(x-370, y+95, duration=.1)
    for line in sentence:
        pt.typewrite(line + "\n", interval=.01)
        with pt.hold('shift'):
            pt.press('tab', presses=5)
        sleep(2)

方式2：用len(sentence)控制循环范围 #

如果坚持使用range循环，只需将循环范围改为range(len(sentence))，确保循环次数和sentence的行数一致：

def post_text():
    pt.moveTo(x-370, y+95, duration=.1)
    for lines in range(len(sentence)):
        pt.typewrite(sentence[lines] + "\n", interval=.01)
        with pt.hold('shift'):
            pt.press('tab', presses=5)
        sleep(2)

关于if-else的说明 #

虽然可以用if-else做边界判断（比如在访问sentence[lines]前检查lines < len(sentence)），但这种方式属于冗余处理——只要循环范围正确，就不会出现越界场景，因此不推荐使用。

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