PyCharm中Python模块导入跨Mac/Windows差异及PyCharm报错问题

这是Python导入路径机制和PyCharm项目结构识别共同导致的现象——代码能正常运行是因为运行时环境满足了导入条件，但PyCharm的静态代码分析没跟上你的实际运行场景，所以出现了「代码能跑但编辑器标红」的矛盾。

一、为什么最初的导入在Mac正常、Windows报错？ #

当你使用from backend.csv_utilities import *时，Python会在sys.path（Python的模块搜索路径）里寻找名为backend的包：

• 在Mac上，你大概率是从backend的上级目录启动脚本（比如执行python backend/webservices.py），这时候上级目录会被自动加入sys.path，backend作为一个可识别的包目录，自然能被找到，导入也就成功了。
• 而在Windows上，你可能是直接进入backend目录运行脚本（比如cd backend && python webservices.py），此时sys.path里只有当前的backend目录，Python找不到名为backend的包（因为当前目录就是backend本身），所以抛出「模块未找到」的错误。

二、为什么修改导入后两边都能运行，但PyCharm标红？ #

改成from csv_utilities import *后：

• 不管你是从上级目录还是backend目录运行脚本，Python都会自动把脚本所在的目录加入sys.path，所以同目录下的csv_utilities.py总能被找到，因此Mac和Windows都能正常运行。
• 但PyCharm的静态代码分析是基于你设置的项目Sources Root的：如果你的PyCharm项目根目录是backend的上级目录，而你没有把backend目录标记为「Sources Root」，PyCharm就不会把这个目录加入它的静态分析搜索路径，所以它会认为csv_utilities是未解析的引用，从而标红。但实际运行时Python的sys.path是动态生成的，和PyCharm的静态分析路径不完全一致，所以代码能正常跑。

三、解决PyCharm标红的两种方法 #

1. 标记Sources Root：
   在PyCharm中找到你的backend目录，右键点击 → 选择「Mark Directory as」→ 「Sources Root」。这样PyCharm就会把这个目录纳入静态分析的导入路径，红标会立刻消失。

2. 用规范的包导入方式：
   给backend目录添加一个空的__init__.py文件（让它成为标准的Python包），然后在webservices.py中使用相对导入：

   from .csv_utilities import *
   

   这种方式不管你从哪个目录启动脚本（只要backend被视为包），导入都能正常工作，同时PyCharm也能正确识别引用，不会标红。

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