PyCharm调试模式下遍历dirs列表出现tuple类型错误求助

问题分析 #

你遇到的是PyCharm调试器的变量名冲突/内部窥探bug：正常运行时dirs是字符串列表，遍历的_dir是单个目录名，但调试模式下，调试器错误地将_dir替换成了os.walk返回的完整三元组(root, dirs, files)，导致os.path.join接收了tuple参数报错。这个问题仅在调试模式触发，是因为调试器跟踪变量时，对部分常见变量名的处理出现了异常。

解决方案 #

1. 重命名循环变量（最直接有效） #

把循环变量_dir改成不与调试器内部变量冲突的名称，比如dir_entry：

for root, dirs, files in os.walk(_path):
    _ex_dir_set    = set()
    _full_dir_list = []
    for dir_entry in dirs:
        _full_dir = os.path.join(root, dir_entry)

重命名后调试器不会再混淆变量，问题可直接解决。

2. 调整PyCharm调试配置 #

• 打开PyCharm的Run/Debug Configurations
• 切换到Debugger标签页
• 取消勾选Collect run-time types information或Enable auto-expression evaluation选项
• 应用配置后重新调试，避免调试器自动求值干扰变量值

3. 更新PyCharm到最新版本 #

这类问题属于调试器的已知bug，JetBrains在后续版本中修复了类似的变量跟踪异常，更新到最新稳定版可彻底解决这类问题。

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