PyCharm无法识别已存在于site-packages中的google_trans_new模块

第一步：核对路径匹配关系（最高发问题） #

• 打开PyCharm设置面板，进入Python解释器配置页，复制当前项目绑定的激活解释器的完整安装路径。
• 手动打开该路径对应的site-packages目录，确认google_trans_new包文件夹确实放置在这个目录下，而非其他Python版本、其他虚拟环境的site-packages路径中。只要项目解释器和包的存放路径不是一一对应，哪怕放10个同类包，PyCharm也永远识别不到。
• 检查包的目录结构：google_trans_new文件夹内必须直接包含__init__.py文件，不能出现多层嵌套结构（比如site-packages/google_trans_new/google_trans_new/这种二级嵌套的无效包路径），拷贝解压后的文件夹时要把外层多余的目录去掉，再放到site-packages下。

第二步：刷新PyCharm的本地索引 #

• PyCharm的包识别依赖本地缓存的索引数据，手动放置的包不会被自动触发扫描。可以先在Python解释器配置页点击已关联的site-packages路径，选择手动刷新。
• 如果刷新后依然无法识别，通过顶部File菜单进入Invalidate Caches选项，勾选清空全部缓存索引，重启项目后等待PyCharm完成全量扫描即可。

第三步：清理旧版本依赖残留 #

• 你之前安装过的googletrans与google_trans_new属于高度同源的翻译类第三方包，极易产生目录冲突、依赖版本不匹配的问题。
• 打开当前项目解释器对应的内置终端，执行pip uninstall googletrans google_trans_new -y完全清除旧版本的残留文件，再重新放置完整的google_trans_new包，避免因为损坏的残留文件导致加载、识别失败。

常见失效原因补充 #

• 目前公开渠道可获取的google_trans_new开源版本已停止维护，部分版本存在谷歌接口规则适配失效的问题。如果完成上述步骤后PyCharm已经可以识别模块，但运行时报接口调用错误，这不属于PyCharm识别故障，是包本身的线上兼容性问题，和安装路径无关。
• 部分安全软件会拦截PyCharm对site-packages目录的读取权限，也会导致模块识别失败，可临时关闭安全软件的目录扫描功能验证权限问题。

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