PyCharm用File→Open打开项目后仍报ModuleNotFoundError，因仅挂载文件夹未配置解释器和源根；必须依次设置Python Interpreter（指向python.exe）和Sources Root（右键目录→Mark as Sources Root），缺一不可。
直接用 File → Open 选中项目根目录即可，但光打开还不够——解释器没配好、路径没认准、文件夹被误排除，运行时照样报 ModuleNotFoundError 或 ImportError。
File → Open 后为什么还不能运行？
PyCharm 只是把文件夹“挂载”进 IDE，不会自动识别 Python 环境或源码结构。常见现象包括：
- 右下角显示
No interpreter configured -
import语句标红，提示模块找不到 - 运行按钮灰掉，或点开后报错
python: command not found
根本原因是：PyCharm 不知道该用哪个 python.exe 解释器，也不知道哪些目录该被当作代码根（即 sys.path 的一部分）。
必须配置的两个关键项：Interpreter 和 Sources Root
缺一不可，顺序建议先配解释器，再设源根：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
- 解释器配置路径：
File → Settings → Project → Python Interpreter（macOS 是PyCharm → Preferences）→ 点右上角+→ 选Existing environment→ 浏览到你的python.exe（Windows）或python3（macOS/Linux）；注意：必须指向可执行文件本身，不是文件夹 - 源根设置：在项目视图中，右键点击含
__init__.py或实际存放模块的目录 →Mark Directory as → Sources Root；图标会变成蓝色小圆点，表示 PyCharm 将其加入sys.path - 如果项目用虚拟环境，优先选虚拟环境里的
python.exe（如venv/Scripts/python.exe或venv/bin/python），避免污染全局环境
导入后 import 仍失败？检查这三处
即使解释器和源根都设了，import 还可能出问题，重点排查：
-
__init__.py缺失：子包目录下没这个空文件，Python 就不认它是包；手动新建一个，内容可为空 - 相对导入写错：比如在
package/submodule.py中写from ..utils import helper，但当前文件没被当作包内模块执行（即没通过python -m package.submodule启动），就会报Attempted relative import in non-package - 被意外排除：某些目录（如
build/、.git/、__pycache__/）可能被 PyCharm 自动标记为Excluded（灰色图标），但如果误把src/或lib/标成 excluded，就真找不到模块了；右键 →Mark Directory as → Cancel Exclusion恢复
要不要动 .idea/misc.xml 手动加 exclude？
绝大多数情况不需要。GUI 操作（右键 → Mark Directory as → Excluded）会自动更新 .idea/misc.xml，手动改容易出格式错误或路径变量写错（比如把 $PROJECT_DIR$ 写成 $PROJECT_DIR 少个 $）。唯一需手动干预的场景是：团队协作时想把排除规则纳入版本控制，且确认所有成员用相同项目结构——这时才去核对 .idea/misc.xml 里 <url url="file://$PROJECT_DIR$/dist"/> 这类行是否准确。
