IntelliJ IDEA中Python自动导入功能失效问题求助

问题详情 #

使用IntelliJ IDEA进行PHP开发时一切正常，但切换到Django开发后，导入自动补全功能异常：

• 环境：Python 3.9、Django 4.0.6、Pipenv虚拟环境
• 具体表现：输入django.http.HttpResponse这类基础内容时，IDE不会自动触发导入提示；需按两次Ctrl+空格才显示建议（第一次提示“无建议”），或输入完整内容后按Option+Return才能触发导入
• 已配置Python自动导入、代码补全通用设置及项目设置，项目已包含Django模块

项目的.iml文件内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<module type="PYTHON_MODULE" version="4">
  <component name="FacetManager">
    <facet type="django" name="Django">
      <configuration>
        <option name="rootFolder" value="$MODULE_DIR$" />
        <option name="settingsModule" value="django_app/settings.py" />
        <option name="manageScript" value="manage.py" />
        <option name="environment" value="&lt;map/&gt;" />
        <option name="doNotUseTestRunner" value="false" />
        <option name="trackFilePattern" value="migrations" />
      </configuration>
    </facet>
    <facet type="Python" name="Python">
      <configuration sdkName="Pipenv (social-media)" />
    </facet>
  </component>
  <component name="NewModuleRootManager" inherit-compiler-output="true">
    <exclude-output />
    <content url="file://$MODULE_DIR$" />
    <orderEntry type="inheritedJdk" />
    <orderEntry type="sourceFolder" forTests="false" />
    <orderEntry type="library" name="Pipenv (social-media) interpreter library" level="application" />
  </component>
</module>

解决方法 #

1. 确认Pipenv环境同步状态 #

• 打开File > Project Structure > SDKs，检查选中的Pipenv解释器是否已加载Django包
• 若Django未显示，终端执行pipenv sync，再在IDE中点击File > Sync Project with Pipfile同步环境

2. 重新配置Django Facet #

• 进入File > Project Structure > Facets，删除现有Django facet，重新添加并确认：
  • rootFolder指向项目根目录
  • settingsModule路径正确（如django_app/settings.py）
  • manageScript指向项目根目录下的manage.py
• 应用设置后重启IDE

3. 优化自动补全触发配置 #

• 打开Settings > Editor > General > Code Completion：
  • 勾选Autopopup code completion，将延迟调整为100ms左右
• 进入Settings > Languages & Frameworks > Python > Code Completion：
  • 勾选Show the import popup和Add unambiguous imports on the fly

4. 清除IDE缓存 #

• 执行File > Invalidate Caches...，选择Invalidate and Restart，缓存损坏是此类问题的常见诱因

5. 调整模块依赖顺序 #

• 检查.iml文件中的orderEntry，确保Pipenv (social-media) interpreter library在sourceFolder之前
• 也可在File > Project Structure > Modules > Dependencies中拖动调整依赖优先级，让第三方库优先于项目源码被索引

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