WinPython中Python Wheel包描述不显示问题求助

嘿，我来帮你捋捋这个WinPython打包和包信息显示的问题，毕竟我之前也碰到过类似的情况：

1. 先确认包的metadata是否正确生成 #

WinPython的控制面板是读取包的metadata来显示描述的，所以第一步得排查metadata有没有问题：

• 打开WinPython自带的终端，执行 pip show <你的包名>，看看输出里有没有Description字段。如果pip能显示，说明metadata是对的，只是WinPython控制面板没加载出来；如果pip也没显示，那就是打包时metadata没正确写入。
• 另外，检查你的setup.py（或setup.cfg），除了description，name、version这些必填字段一定要正确设置，缺少必填项可能导致metadata生成不全。

2. 重新生成wheel包，确保metadata嵌入正确 #

有时候打包过程中会出现metadata丢失的情况，建议重新打包试试：

• 先清理旧的打包产物：Windows终端里执行 rmdir /s /q dist build *.egg-info
• 重新生成wheel：用 pip wheel . （这个比python setup.py bdist_wheel更稳妥，能自动处理依赖）
• 生成后可以解压wheel包，查看EGG-INFO/PKG-INFO文件，里面应该有Description:和Long-Description:字段，确认内容是否和你设置的一致。

3. 解决WinPython控制面板的刷新问题 #

WinPython的控制面板有时候会有缓存，不会自动更新包信息：

• 如果已经安装了包，先在控制面板里卸载它
• 关闭并重新打开WinPython控制面板
• 重新用拖拽或者pip install <你的包名>.whl命令安装，之后再查看已安装包列表。

安装后想查看long_description有几种办法：

• 用pip命令查看：在WinPython终端执行 pip show <你的包名>，如果long_description内容不长，会直接显示；如果太长被截断，可以看输出里的Location:字段，找到包的安装目录，打开里面的EGG-INFO/PKG-INFO文件，里面有完整的长描述。
• 用Python代码读取：Python3.6需要先安装importlib_metadata包（pip install importlib_metadata），然后执行以下代码：

  from importlib_metadata import metadata
  pkg_meta = metadata("<你的包名>")
  print("短描述：", pkg_meta["Description"])
  print("长描述：", pkg_meta["Long-Description"])
  

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