从你的描述来看，代码执行到print('step_1')后就卡住，说明问题出在cv2.namedWindow调用上，而且没有报错，这通常和图像加载异常、OpenCV GUI后端依赖或者显示环境有关。下面是几个可能的原因和对应的解决思路：

1. 图像加载失败导致后续操作卡住 #

OpenCV的cv2.imread如果加载失败会返回None，但后续传入cv2.namedWindow或cv2.imshow时，不会直接抛出错误，而是会导致程序无响应。你可以先检查图像是否成功加载：

修改代码，增加加载校验：

import cv2
import os

# 用绝对路径确保图片能被正确找到
script_dir = os.path.dirname(os.path.abspath(__file__))
image_path = os.path.join(script_dir, 'girl.jpg')
image_cv2 = cv2.imread(image_path)

# 检查图像是否加载成功
if image_cv2 is None:
    print(f"Error: 无法加载图片，路径为 {image_path}")
    exit()

def viewImage(image, name_of_window):
    print('step_1')
    cv2.namedWindow(name_of_window, cv2.WINDOW_NORMAL)
    print('step_2')
    cv2.imshow(name_of_window, image)
    print('step_3')
    cv2.waitKey(0)
    print('step_4')
    cv2.destroyAllWindows()

cropped = image_cv2
viewImage(cropped, 'Cropped version')

另外，VS Code的默认工作目录可能不是脚本所在目录，用os.path拼接绝对路径能避免路径问题。

2. OpenCV GUI后端依赖缺失或不兼容 #

Fedora系统中，OpenCV的GUI功能依赖GTK、Qt等库，如果这些依赖没有正确安装，cv2.namedWindow无法创建窗口就会卡住。

• 首先检查OpenCV的编译配置，运行以下代码查看GUI后端支持情况：

  print(cv2.getBuildInformation())
  

  找到GUI部分，看是否有GTK+或Qt的支持标记（比如YES）。

• 如果缺少依赖，在Fedora上安装对应的库：

  # 安装GTK3依赖
  sudo dnf install gtk3-devel
  # 或者安装Qt5依赖
  sudo dnf install qt5-devel
  

  之后可以尝试重新安装OpenCV的完整版：

  pip uninstall opencv-python
  pip install opencv-contrib-python
  

  opencv-contrib-python包含了更多的GUI组件和功能，可能解决依赖问题。

• 尝试更换窗口创建的标志，比如用cv2.WINDOW_AUTOSIZE替代cv2.WINDOW_NORMAL，或者强制指定GUI后端：

  cv2.namedWindow(name_of_window, cv2.WINDOW_GUI_NORMAL)
  

3. 显示环境限制（远程连接/无桌面） #

如果是在无桌面的服务器上运行，或者通过SSH远程连接没有开启X11转发，OpenCV无法创建GUI窗口，会导致程序卡住。

• 如果你用SSH远程连接，需要开启X11转发：

  ssh -X your_username@your_server_ip
  

  同时本地需要安装X服务器（Windows用Xming，Mac用XQuartz）。

• 如果是无桌面环境，可以跳过GUI显示，直接保存图片验证：

  cv2.imwrite('cropped_output.jpg', cropped)
  

  或者使用虚拟显示工具xvfb：

  sudo dnf install xvfb
  xvfb-run python your_script.py
  

4. OpenCV版本与Fedora系统不兼容 #

某些OpenCV版本和Fedora的系统库可能存在兼容性问题，导致GUI功能异常。你可以尝试升级或降级OpenCV版本：

# 升级到最新版本
pip install --upgrade opencv-python
# 或者降级到稳定版本，比如4.5.5.62
pip install opencv-python==4.5.5.62

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