PyCharm脚本部分输出无法被屏幕阅读器NVDA读取的问题

问题场景 #

为初学编程的视障开发者选用PyCharm（相比IDLE具备更优的无障碍特性），但测试发现：

• 交互式脚本在PyCharm中运行时，部分输出无法被NVDA屏幕阅读器朗读；在cmd或PowerShell中运行则所有输出正常
• 添加time.sleep()延迟无法解决问题
• 仅含循环print语句的脚本在PyCharm中无任何朗读输出，命令行环境下正常

测试代码：

交互式测试脚本 #

# just_ask.py 12Aug2020 crs
"""
Demonstrate PyCharm / NVDA limitations with interactive script
"""
import time

inp = input("Enter Guess:")
print("From User:", inp)
print("We would like to hear this line")
ts = 5
print(f"Sleep {ts} seconds incase a pause would help")
time.sleep(ts)
print(f"After waiting")

循环测试脚本 #

import time
for n in range(1, 10+1):
    print("We would like to hear this line", n)
    time.sleep(1)

核心原因 #

PyCharm自带的Run Console是自定义的文本渲染组件，并非系统原生终端。NVDA对这类非原生控件的实时内容更新捕获存在兼容性缺陷，尤其是批量输出、延迟输出的场景，无法像原生终端那样及时识别并朗读内容。

解决方案 #

1. 切换到系统原生终端运行脚本 #

这是最彻底的解决方法，让脚本在NVDA完全兼容的原生终端中执行：

• 打开PyCharm设置（快捷键Ctrl+Alt+S）
• 进入Build, Execution, Deployment > Console > Python Console，勾选Use terminal选项
• 进入Run/Debug Configurations，针对目标Python脚本，勾选Emulate terminal in output console
• 配置完成后，脚本会在cmd或PowerShell中运行，NVDA可正常朗读所有输出

2. 强制输出刷新（临时 workaround） #

如果暂时无法切换到原生终端，可通过强制刷新输出缓冲区，让PyCharm控制台及时输出内容：

• 修改print语句，添加flush=True参数：

  print("需要朗读的内容", flush=True)
  

• 循环测试脚本修改后示例：

  import time
  for n in range(1, 10+1):
      print("We would like to hear this line", n,, flush=True)
      time.sleep(1)
  

• 该方法能提升NVDA识别概率，但仍可能存在部分场景不兼容的情况

3. 版本兼容性检查 #

• 确保使用最新版本的NVDA和PyCharm，新版本通常会修复更多无障碍兼容性问题
• 在NVDA设置中开启高级 > 控制台输出相关选项，增强对非原生终端的内容识别能力

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