pycharm中导入本地模块失败的本质是python解释器未将目标文件夹加入sys.path，而mark as sources root可同步修正ide分析与运行时路径，使import直接生效，但该设置仅限pycharm内部有效。
PyCharm 导入本地文件夹，本质是解决 Python 模块导入路径问题。直接 import xxx 报 ModuleNotFoundError，不是代码写错了，而是 Python 解释器根本没把那个文件夹当成可搜索的模块位置。关键不在“怎么点”，而在“让解释器和 IDE 同时认路”。
为什么右键 Mark as Sources Root 最常用
这是 PyCharm 提供的最轻量、最安全的路径注册方式：它只改 IDE 的 PYTHONPATH，不碰代码，也不影响命令行运行。
- 右键目标文件夹（比如
utils）→Mark Directory as→Sources Root，图标变蓝即生效 - 该操作会把文件夹路径自动加进
sys.path，但仅限 PyCharm 内部运行/调试时生效 -
main.py里可以直接写import helper（假设helper.py在utils下），无需from utils import helper - 如果项目要打包或部署到服务器，这个设置不生效——它只是 IDE 层面的便利，不是代码逻辑的一部分
想脱离 PyCharm 也能跑？必须做成标准包
只要运行环境不是 PyCharm（比如终端执行 python main.py），就必须靠 Python 自身的包机制。核心是两个动作：加 __init__.py + 用绝对导入。
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 在目标文件夹下新建空文件
__init__.py（哪怕内容为空，也必须存在） - 确保项目根目录（含
main.py的那一层）是当前工作目录，或通过-m方式运行：python -m mypackage.main - 导入写法必须是绝对路径风格：
from utils.helper import some_func，不能只写import helper - 如果
main.py不在根目录，或者你用python xxx/main.py运行，Python 就不会自动把根目录加入sys.path，此时会再次报错
临时加路径？sys.path.append() 是双刃剑
硬编码路径能快速绕过导入失败，但极易出错，只适合调试或极简脚本，绝不该出现在正式代码中。
- 常见写法：
import sys, os; sys.path.append(os.path.abspath('path/to/folder')) - 路径必须是绝对路径，相对路径在不同工作目录下行为不可控
- Windows 下路径分隔符要用双反斜杠
\或原始字符串r'C:xxx'，单斜杠'C:xxx'会导致转义错误（如C:user变成C:ser） - 每次运行都得重复添加，且多个脚本之间不共享
sys.path修改，维护成本高
别忽略 PyCharm 的 Python Console 设置
即使标记了 Sources Root，如果在 PyCharm 的 Python Console 里导入失败，大概率是因为 Console 没启用源根路径。
- 进入
Settings → Build, Execution, Deployment → Console → Python Console - 勾选
Add content roots to PYTHONPATH和Add source roots to PYTHONPATH - 不勾这两个选项，Console 里
import依然会失败，和编辑器里正常运行形成反差，容易误判问题所在
真正麻烦的从来不是“怎么点几下”，而是搞清哪条路径对哪个执行环境生效：IDE 运行、终端运行、Python Console、测试框架……每种场景背后是不同的 sys.path 构建逻辑。标记 Sources Root 解决了 80% 的日常开发问题，但只要涉及跨环境部署，就得回归标准包结构——否则迟早掉坑里。
