导入突然失效：出现Unresolved reference错误求助

一、先排查基础错误 #

• 核对导入名与文件名：你的导入语句是from flop_turn_river_cards import TheRiver，但实际文件是poker/flop_turn_river.py——如果文件名确实是flop_turn_river.py，那导入语句应该是from flop_turn_river import TheRiver，这是最容易忽略的低级错误，先确认这一点。

二、测试导入问题的方法 #

1. 交互式环境验证
   进入poker目录，启动Python解释器，执行以下命令：

   import sys
   print(sys.path)  # 查看Python当前的模块搜索路径
   from flop_turn_river import TheRiver  # 替换为正确的导入语句
   

   • 如果这里报错，说明是路径未配置；如果能成功导入，那问题出在IDE的项目配置上。

2. 临时路径调试
   在analyse_hand_on_river.py开头添加以下代码，强制将poker目录加入搜索路径：

   import sys
   from pathlib import Path
   # 向上两级目录就是poker根目录
   sys.path.append(str(Path(__file__).parent.parent))
   
   # 再执行你的导入
   from flop_turn_river import TheRiver
   

   如果这样能正常运行，就可以确定是项目根目录未被加入Python搜索路径导致的问题。

三、将poker设置为项目根目录的方法 #

1. IDE配置（主流IDE示例） #

• PyCharm：右键点击poker文件夹，选择「Mark Directory as > Sources Root」，IDE会自动将该目录加入模块搜索路径，导入报错会立即消失。
• VS Code：打开设置，搜索python.analysis.extraPaths，添加poker目录的绝对路径；或者在项目根目录创建.env文件，写入PYTHONPATH=/你的poker目录绝对路径。

2. Conda环境变量配置 #

激活你的Conda环境后，执行对应系统的命令：

• Windows：set PYTHONPATH=C:\你的poker目录路径
• Linux/macOS：export PYTHONPATH=/你的poker目录路径
  如果要永久生效，把上述命令添加到Conda环境的激活脚本中（Windows是环境目录/Scripts/activate.bat，Linux/macOS是环境目录/bin/activate）。

3. 规范项目包结构 #

在poker目录下创建空的__init__.py文件，将其转为Python包，之后可以用两种方式导入：

• 绝对导入：from poker.flop_turn_river import TheRiver
• 相对导入（仅在包内模块中有效）：在analyse_hand_on_river.py中写from ..flop_turn_river import TheRiver，注意这种方式下不能直接运行该脚本，需用python -m poker.analyse_hand_river.analyse_hand_on_river执行。

四、修复流程总结 #

1. 先确认导入语句的模块名与实际文件名完全匹配；
2. 优先通过IDE将poker设为Sources Root（开发场景最便捷）；
3. 若需跨环境运行，通过PYTHONPATH环境变量或规范包结构解决。

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