Python同目录players模块无法导入 常规修复方案无效求助

Python 3.8.2环境下，运行脚本与待导入的players.py处于同一目录，但导入始终失败，尝试公开渠道常见的sys.path.append()类方案均未彻底解决，具体报错：

• 执行from . import players时抛出：ImportError: attempted relative import with no known parent package
• 执行import players时抛出：ModuleNotFoundError: No module named 'players'

已尝试的无效方案：

• sys.path.append(".")
• sys.path.append(os.getcwd() + "\\players.py")（仅极少数场景可运行，无通用性）
• sys.path.append(os.getcwd())

报错根因 #

先明确两个核心逻辑，避开所有无效试错：

1. 带.的相对导入仅在脚本作为包内模块被导入时生效，直接运行单个.py文件时不存在父包上下文，必然报相对导入错误，单脚本运行场景不要用相对导入写法。
2. sys.path是Python搜索模块的目录路径列表，仅会遍历列表内的目录查找可导入模块：
   • 传入"."或os.getcwd()取的是执行python命令时的终端工作目录，如果你在其他路径下通过绝对路径调用脚本，这两个值和脚本实际存放目录完全无关，自然找不到同目录的players.py
   • 传入具体文件路径（比如拼接了\\players.py的路径）属于语法错误，sys.path不会识别文件路径，仅会在极特殊场景下偶然触发可运行状态，没有任何通用性。

方案1：单脚本直接运行（零改结构，全场景兼容） #

把当前运行脚本自身所在的绝对目录插入到sys.path的最优先级，代码放在所有导入逻辑的最开头即可，和你执行命令时的工作目录完全无关：

import sys
import os
# 获取当前脚本自身所在的绝对目录，不依赖终端工作路径
script_dir = os.path.dirname(os.path.abspath(__file__))
sys.path.insert(0, script_dir)

# 后续直接导入即可，不要加.
import players

这个写法兼容所有调用场景，不管你在哪个终端路径下执行这个脚本，都能准确定位到同目录下的players.py。

方案2：多文件项目规范写法（官方推荐） #

如果是多文件项目，按照Python包规范调整结构即可，不需要手动改sys.path：

1. 在存放运行脚本和players.py的目录下，新建空文件命名为__init__.py，将该目录标记为Python可识别的包
2. 终端切换到该目录的上一级（即项目根目录），使用-m参数以模块模式运行脚本，比如你的运行脚本名为main.py，所在目录名为my_app，执行命令：

cd 你的项目根目录绝对路径
python -m my_app.main

这种模式下不管是用from . import players的相对导入，还是直接写import players都可以正常运行，是Python项目的标准导入写法。

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