升级PyCharm2018.1与Python3.6.5后出现unresolved reference 'join'的原因及解决

首先，这个警告是PyCharm静态代码分析器的误报——程序能正常运行，说明Python解释器在运行时完全能找到join和expanduser。根源主要有两个：

• os.path是动态加载的模块：不同操作系统下它会指向不同的实现（Windows对应ntpath，Linux/macOS对应posixpath），PyCharm 2018.1的静态分析逻辑没处理好这种动态映射，导致无法识别join这类符号。
• Python 3.6.5的os.path模块结构有细微调整，而老版本PyCharm的索引逻辑没适配这个变化。

下面是几个亲测有效的方案，按推荐程度排序：

1. 升级PyCharm到更高版本 #

2018.1是比较老旧的版本，JetBrains在后续更新中修复了大量静态分析的bug，尤其是针对标准库动态模块的识别问题。建议升级到2018.3或更高版本（如果兼容你的开发环境），大概率能直接解决这个误报。

2. 彻底重建PyCharm索引 #

有时候单纯清除缓存不够，需要强制重建整个项目的索引：

• 点击顶部菜单栏的File -> Invalidate Caches / Restart
• 在弹出窗口中选择Invalidate and Restart，等待PyCharm重启并重新索引项目
• 重启后检查警告是否消失

3. 调整PyCharm的检查规则 #

如果暂时不想升级IDE，可以手动让PyCharm忽略这个误报：

• 打开Settings/Preferences（Windows/Linux按Ctrl+Alt+S，Mac按Cmd+,）
• 导航到Editor -> Inspections -> Python -> Unresolved reference
• 在右侧的Ignore references输入框中添加os.path.join和os.path.expanduser
• 点击Apply保存设置，警告就会被屏蔽

4. 修改导入方式（临时 workaround） #

如果上面的方法都没用，可以换一种导入方式避开静态分析的问题：

方案A：使用完整模块引用 #

import os.path

# 后续代码用 os.path.join(...) 和 os.path.expanduser(...)

PyCharm能正确识别完整模块路径下的符号，不会报警告。

方案B：添加类型提示（小技巧） #

在导入后给join和expanduser加类型注释，告诉PyCharm这是合法的符号：

from os.path import join, expanduser
from typing import Callable

join: Callable
expanduser: Callable

这种方式不影响代码功能，也能快速消除警告。

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