1. 运行方式不正确

在命令行中运行Python脚本时，如果不在项目根目录下运行，Python可能无法正确识别模块路径。

错误方式：

C:\Users\User> python project/main.py

正确方式：

C:\Users\User> cd project
C:\Users\User\project> python main.py

2. sys.path未包含当前目录

Python在导入模块时会搜索sys.path中的路径，如果当前目录不在其中，会导致导入失败。

验证方式：

import sys
print(sys.path)  # 检查当前目录是否在输出列表中

3. 相对导入与绝对导入混淆

在包内部使用相对导入时，需要确保文件是作为模块运行的，而不是作为主脚本运行。

相对导入示例：

# 在同一目录下
from . import module_name  # 相对导入

方法1：修改sys.path添加当前目录

在脚本开头动态添加当前目录到Python路径：

import os
import sys

# 获取当前文件所在目录
current_dir = os.path.dirname(os.path.abspath(__file__))
# 添加到sys.path
sys.path.insert(0, current_dir)

# 现在可以导入同目录下的模块
import utils

方法2：使用绝对导入

对于简单项目，使用绝对导入确保路径正确：

# 在main.py中导入同目录的utils模块
import utils

# 使用utils中的函数
utils.some_function()

确保目录结构正确：

project/
├── main.py
└── utils.py

方法3：将目录转换为Python包

创建__init__.py文件使目录成为包：

project/
├── __init__.py  # 可以是空文件
├── main.py
└── utils.py

然后使用绝对导入：

# main.py
from project import utils

# 或者
from . import utils  # 相对导入（当作为模块运行时）

方法4：使用-m参数运行模块

在命令行中使用-m参数将脚本作为模块运行：

# 在项目根目录的上一级运行
python -m project.main

这种方法会自动设置正确的导入路径。

Q: 为什么在PyCharm中可以导入，但在命令行中不行？

A: PyCharm会自动将项目根目录添加到sys.path，而命令行不会。解决方法是在命令行中进入项目根目录运行，或使用-m参数。

Q: 相对导入和绝对导入哪个更好？

A: 在包内部推荐使用相对导入，在顶层脚本或模块间导入推荐使用绝对导入。避免在脚本文件中使用相对导入。

Q: 添加__init__.py文件后仍然无法导入怎么办？

A: 确保：1) 在正确的目录层级运行脚本；2) 包名称没有与标准库冲突；3) 使用Python 3.3+（支持隐式命名空间包）。