PyCharm调试卡住及AttributeError: 'Queue' object has no attribute 'put'的排查与解决

七月
七月
发布时间:2026-10-13| 5人浏览过
原创

本文总结了PyCharm调试时出现“process XXXX is connecting”且长期等待无响应的问题。在尝试网络解禁和清理.idea文件夹等常规方案无效后,通过定位AttributeError: 'Queue' object has no attribute 'put'错误,发现是用户自定义的queue.py文件覆盖了Python内置模块。重命名自定义文件后问题得以解决,核心原因在于文件名与标准库冲突导致调试器调用错误。

问题现象:在PyCharm环境中编写Python代码时,程序能够正常运行,但突然无法进入Debug模式。系统提示“pydev debugger: process XXXX is connecting”,随后便一直停留在等待连接的状态,最终导致报错。

针对该错误,网络上常见的解决思路包括以下几种:

第一种方案是检查PyCharm的网络设置,确认是否被禁用。若被禁用,需重新启用网络权限以允许调试器通信。

第二种方案是删除项目目录下的“.idea”文件夹,然后重启项目,以清除可能的缓存或配置错误。

在尝试上述所有常规方案均无效后,仔细检查报错日志,发现关键错误信息为AttributeError: 'Queue' object has no attribute 'put'。

由此推测,该错误可能与项目中自定义编写的queue.py文件中的Queue类定义有关。

将自定义的queue.py文件重命名后,Debug功能恢复正常,问题得到解决。

根本原因推测:用户自定义的queue.py文件名与Python3内置的标准库模块queue.py同名。当调试程序尝试调用标准库的Queue类时,优先加载了用户自定义的文件,而自定义文件中可能未正确实现put方法,从而引发AttributeError。

以上关于PyCharm无法Debug问题的排查与解决经验分享完毕,希望能为遇到类似问题的开发者提供参考。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。