Python警告‘Setuptools is replacing distutils’含义及help模块报错问题

以下是你操作时出现的终端输出：

Python 3.11.4 (tags/v3.11.4:d2340ef, Jun  7 2023, 05:45:37) [MSC v.1934 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> help()

Welcome to Python 3.11's help utility!

If this is your first time using Python, you should definitely check out
the tutorial on the internet at https://docs.python.org/3.11/tutorial/.

Enter the name of any module, keyword, or topic to get help on writing
Python programs and using Python modules.  To quit this help utility and
return to the interpreter, just type "quit".

To get a list of available modules, keywords, symbols, or topics, type
"modules", "keywords", "symbols", or "topics".  Each module also comes
with a one-line summary of what it does; to list the modules whose name
or summary contain a given string such as "spam", type "modules spam".

help> modules

Please wait a moment while I gather a list of all available modules...

test_sqlite3: testing with version '2.6.0', sqlite_version '3.42.0'
C:\Users\lenovo\AppData\Local\Programs\Python\Python311\Lib\site-packages\_distutils_hack\__init__.py:33: UserWarning: Setuptools is replacing distutils.
  warnings.warn("Setuptools is replacing distutils.")

这个警告的核心含义：

• distutils是Python早期内置的包构建、分发工具，功能偏基础，官方已将其标记为弃用，Python 3.12及后续版本已完全移除该模块。
• Setuptools是distutils的增强替代工具，支持更多现代Python包管理特性，比如依赖管理、轮子包（wheel）构建等。
• 当你的Python环境安装了Setuptools时，它会自动接管原本由distutils负责的功能，用自身实现替换原生distutils，这个警告就是在告知你这一替换行为正在进行，避免你误以为仍在使用原生distutils模块。

后续处理建议 #

• 该警告属于提示性质，一般不会影响代码运行，可直接忽略。
• 若想关闭警告，可设置环境变量：PYTHONWARNINGS="ignore::UserWarning"
• 对于依赖distutils的旧项目，建议逐步更新相关代码或依赖包，适配Setuptools的使用方式。

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