如何解决Windows10下PyCharm中PyTorch无智能提示文档的问题？

作为同样踩过这个坑的开发者，我来分享几个亲测有效的解决办法，帮你找回PyTorch的API文档提示：

1. 确认PyCharm使用的是正确的Anaconda环境 #

首先得确保PyCharm关联的是你安装了PyTorch的那个Anaconda环境：

• 打开PyCharm，依次点击File > Settings > Project: [你的项目名] > Python Interpreter
• 在下拉列表里选择你通过Anaconda创建的、装了PyTorch的环境（比如默认的base或者你自定义的环境）
• 如果列表里没找到，点击右侧的齿轮图标，选Add > Conda Environment，找到对应环境的路径添加进去

2. 强制PyCharm重新索引项目 #

有时候索引没更新会导致文档无法加载：

• 点击顶部菜单栏的File > Invalidate Caches...
• 在弹出窗口勾选Clear file system cache and local history，然后点击Invalidate and Restart
• 重启后PyCharm会重新索引所有依赖包，等它完成后再试试查看torch.randn的文档

3. 重装带完整文档的PyTorch包 #

有些精简版或源码编译的PyTorch可能缺失文档文件，你可以先在Anaconda Prompt里执行：

conda list torch

确认当前安装的版本，然后重新安装官方提供的完整包：

# CPU版本，GPU版替换成对应官方命令
conda install pytorch torchvision torchaudio cpuonly -c pytorch

安装完成后回到PyCharm，点击解释器列表旁的刷新按钮重新加载环境

4. 检查PyCharm的文档显示设置 #

有可能是文档显示的开关没打开：

• 打开File > Settings > Editor > General > Code Completion
• 确保勾选Show the documentation popup in 1000 ms（时间可以自行调整）
• 再进入Editor > General > Documentation，确认Synchronize documentation with editor和Show quick documentation on mouse move都已勾选

5. 手动添加PyTorch的源码目录为源根 #

如果上面的方法都没用，可以手动指定PyTorch的源码路径：

• 找到你的Anaconda环境下的PyTorch安装目录，比如C:\Users\[你的用户名]\anaconda3\Lib\site-packages\torch
• 打开Settings > Project Structure，点击Add Content Root，把这个torch目录添加进去
• 右键点击这个根目录，选择Mark Directory as > Sources Root，之后再重新索引一次

按照上面的步骤一步步试，应该就能解决文档不显示的问题啦。我当初就是通过重新索引和确认解释器配置搞定的，祝你顺利！

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