PyCharm无法加载NumPy等库Inline文档问题求助

问题回顾 #

• 用Miniconda环境、conda install安装的NumPy、Matplotlib代码可正常运行，但PyCharm按Ctrl+Q无法显示Inline文档描述
• NumPy原文档链接指向404，修改URL模板后能跳转正确页面，但仍无文档描述
• Matplotlib文档链接打开的是2.0.2弃用版本，无函数英文描述
• 已尝试：切换解释器、清除缓存重启、修改文档字符串格式、调整文档链接

解决方案 #

• 重装带完整文档的库
  Conda默认安装的包可能缺失离线文档，执行命令重新安装：

  conda install numpy matplotlib --update-deps --force-reinstall
  

  也可以单独安装文档包：

  conda install numpy-doc matplotlib-doc
  

• 检查解释器配置细节

  1. 打开File > Settings > Project: [你的项目名] > Python Interpreter
  2. 选中当前Miniconda解释器，点右侧齿轮选Show All
  3. 选中对应解释器后点Edit，确认Interpreter path指向Miniconda环境下的Python可执行文件，同时Environment variables包含Miniconda路径
  4. 应用设置后重启PyCharm

• 重建PyCharm文档索引

  1. 打开File > Invalidate Caches...
  2. 勾选Clear file system cache and local history，点击Invalidate and Restart
  3. 重启后等待PyCharm完成索引构建（右下角显示进度），再测试Ctrl+Q

• 调整文档获取设置

  1. 打开File > Settings > Tools > Python Integrated Tools
  2. Docstring format下拉选NumPy（适配NumPy）或Google（适配Matplotlib多数函数）
  3. 找到Documentation区域，确认Fetch documentation from选Python Standard Library and installed packages，勾选Download documentation for installed packages
  4. 应用设置后，PyCharm会自动下载缺失的包文档

• 修正在线文档模板

  1. 打开File > Settings > Languages & Frameworks > Python > Documentation
  2. NumPy条目修改URL模板为：https://numpy.org/doc/stable/reference/generated/{element.qname}.html
  3. Matplotlib条目修改URL模板为：https://matplotlib.org/stable/api/_as_gen/{element.qname}.html
  4. 应用设置后测试文档链接是否跳转最新稳定版

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