Great catch noticing the sys.path discrepancy between IDLE and your terminal—that’s almost certainly the root cause here! Let’s break down the fixes step by step:

1. 先确认IDLE和终端用的是同一个Python解释器 #

First, make sure IDLE isn’t using a different Python version than your terminal:

• In your terminal, run:

  python --version  # 或者 python3 --version，看你平时用哪个
  

• In IDLE’s shell, run this code:

  import sys
  print(sys.version)
  

If the versions don’t match, Pygame is only installed in your terminal’s Python environment, which is why IDLE can’t find it.

2. 手动给IDLE添加Pygame的安装路径 #

If the versions are the same but sys.path still differs, first find where Pygame is installed in your terminal:

pip show pygame | grep Location  # 用pip3如果对应python3

Copy that path, then add it to the top of your IDLE code before importing Pygame:

import sys
sys.path.append("/your/pygame/install/location")  # 替换成你拿到的实际路径

# 然后正常运行你的测试代码
import pygame
pygame.init()
screen = pygame.display.set_mode((640, 480))
screen.fill((0, 255, 0))
pygame.display.flip()
pygame.time.wait(3000)

3. 直接从终端启动对应版本的IDLE（最彻底的解决方法） #

If the problem is mismatched Python versions, skip manual path edits entirely:

• Activate your terminal’s Python environment (if using a virtual env)
• Run this command to launch IDLE using the same Python instance as your terminal:

  python -m idlelib  # 用python3 -m idlelib如果对应python3
  

This IDLE instance will share the exact same sys.path as your terminal, so Pygame will import without any issues.

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