本地VSCode窗口最小化致远程服务器tqdm Python代码减速10倍

现象还原 #

• 通过VSCode SSH连接远程服务器，在终端运行包含tqdm进度条的Python代码，正常运行速度约2995.91it/s
• 本地VSCode窗口最小化后，Windows自动将VSCode切换到效率模式，远程代码运行速度直接暴跌至61.48it/s（慢10倍以上）
• 重新激活VSCode窗口后，代码速度立刻恢复正常；但如果用nohup把代码放远程后台运行，完全不受本地VSCode状态影响

问题根源 #

核心在于**tqdm的实时终端交互+VSCode SSH的输出依赖**：
tqdm的进度条是通过不断刷新终端当前行实现的，这要求远程Python进程持续向本地VSCode终端输出数据，而本地终端需要实时渲染这些动态内容。

当VSCode进入Windows效率模式后，本地的终端渲染线程被系统限制了CPU优先级，导致本地接收、处理远程输出的速度大幅下降。此时远程服务器的Python进程的输出缓冲区会被快速占满，触发TCP的流量控制机制——远程进程不得不暂停执行，等待本地缓冲区腾出空间，最终表现为代码运行速度骤降。

而用nohup后台运行时，代码输出被重定向到文件，不需要和本地终端实时交互，自然不会受本地VSCode的状态影响。

解决办法 #

1. 阻止VSCode被Windows自动设为效率模式 #

• 打开Windows「设置」→「系统」→「电源和电池」→「电池优化」，找到Visual Studio Code，设置为「不允许」
• 或者修改VSCode配置，强制提升终端进程优先级：在settings.json中添加

  "terminal.integrated.windows.enableConpty": false,
  "terminal.integrated.processLauncher": "legacy"
  

2. 剥离tqdm与本地终端的实时绑定 #

运行代码时，将进度输出重定向到文件，避免本地终端的渲染压力：

python your_script.py > progress.log 2>&1

之后可以通过tail -f progress.log在终端查看实时进度，或者直接查看文件内容。

3. 远程后台运行代码（彻底脱离VSCode终端） #

用nohup或会话管理工具（screen/tmux）在远程服务器后台启动代码，完全脱离VSCode的终端会话：

# nohup后台运行
nohup python your_script.py &

# 或者用tmux创建持久会话（推荐）
tmux new -s task_session
# 在tmux会话里运行代码，之后按Ctrl+B+D detach会话，关闭VSCode也不会中断

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