IntelliJ IDEA Python3.6 索引错误：同目录模块引用配置问题

我之前也碰到过一模一样的问题，明明文件就在同目录下，IDE却死活识别不了，改相对导入又跑不起来，给你几个靠谱的解决步骤：

1. 把当前目录标记为「Sources Root」 #

这是最关键的一步，IDEA需要明确知道哪些目录是Python的源码根目录，才能正确索引里面的模块：

• 在IDEA的「Project」视图里，找到包含common.py、environment.py、evaluation.py的那个目录
• 右键点击该目录，选择「Mark Directory as」→「Sources Root」
  标记后目录会变成蓝色，这时候IDE就能正确识别同目录下的模块了，直接写import common就不会报红。

2. 确认Python SDK配置为3.6版本 #

有时候IDE用的解释器版本不对，也会导致索引异常：

• 打开「File」→「Project Structure」（快捷键：Ctrl+Alt+Shift+S）
• 进入「Project Settings」→「Project」，确认「Project SDK」是Python 3.6
• 再切换到「Modules」选项卡，检查对应模块的「Python SDK」也是3.6版本

3. 调整导入检查的相关设置（可选） #

如果前面两步做完还是有问题，可以检查一下IDE的代码检查设置：

• 打开「File」→「Settings」（快捷键：Ctrl+Alt+S）
• 进入「Editor」→「Inspections」→「Python」→「Unresolved reference」
• 确保没有把当前目录排除在检查范围外，或者可以尝试点击「Configure ignored references」，把common添加进去（不过这是兜底方案，优先用前面的方法）

补充说明：为什么.common能消除IDE错误但运行不了？ #

当你直接运行Python脚本（比如python environment.py）时，当前脚本是以__main__模块的身份执行的，不属于任何包结构，这时候用相对导入（.common）会触发Python的导入错误——因为Python找不到对应的父包。所以正确的做法是用绝对导入，同时让IDE识别目录为源码根，这样既能让IDE正常索引，又能保证代码在Python 3.6中正常运行。

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