常见错误与解决方法
排查问题的核心原则
所有 Python 环境问题的排查，都从一条命令开始：
python -c "import sys; print(sys.executable)"
这条命令告诉你：当前正在使用的 Python 到底在哪里。
如果路径不是你想要的环境（比如应该用 organchip 但路径显示是 base），那所有后续的问题（找不到包、版本不对、安装了但无法导入）都可能来自环境选错。
先确认当前 Python 是谁，再判断为什么找不到包。 这个顺序不要颠倒。
常见错误总表
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
conda 不是内部或外部命令 | 没有使用 Anaconda Prompt，或 conda 未初始化 | 使用 Anaconda Prompt 而不是普通 CMD |
ModuleNotFoundError: No module named 'xxx' | 当前环境没有安装这个包，或环境选错 | conda list 检查，如果不是目标环境则切换 |
| VS Code 运行的不是 organchip 环境 | 解释器选错了 | 查看 sys.executable，重新选择解释器 |
| pip 装了包但 Python 还是找不到 | pip 和 python 不是同一个环境 | 使用 python -m pip install xxx |
| Python 版本太老或太新 | 某个包不支持当前 Python 版本 | 创建新环境并指定合适的 Python 版本 |
| base 环境被装乱了 | 太多包混装在 base | 创建新的独立环境，不要动 base |
| matplotlib 中文乱码 | 默认字体不支持中文 | 设置中文字体或使用英文标注 |
| 路径中有空格或中文导致问题 | Windows 用户名包含中文，或项目路径有空格 | 安装 Miniconda 在纯英文路径，项目路径也用纯英文 |
| 权限不足 / 安装失败 | 安装在 Program Files，或缺少管理员权限 | 安装在用户目录下 |
| 网络连接失败 / 下载包很慢 | 网络问题 | 换网络或稍后重试 |
| conda 卡住不动 | 正在解析依赖，或网络超时 | 等待 2-3 分钟，如果仍卡住按 Ctrl+C 取消重试 |
| VS Code 终端里能运行，编辑器中不能 | 编辑器未选择正确的解释器 | 检查左下角 Python 解释器选择是否正确 |
错误 1：conda 不是内部或外部命令
原因：
- 你可能在使用普通 CMD 而不是 Anaconda Prompt
- Miniconda 没有正确初始化
- 安装时没有勾选相关选项
解决方法：
Windows 新手优先使用 Anaconda Prompt 而不是普通 CMD。
在 Anaconda Prompt 中运行：
conda --version
如果 Anaconda Prompt 中正常、普通 CMD 中不能用，这不影响使用。继续用 Anaconda Prompt 即可。
错误 2：ModuleNotFoundError
示例报错：
ModuleNotFoundError: No module named 'numpy'
这通常不是 Python 坏了，而是以下原因之一：
- 当前环境没有安装这个包
- 你运行代码的环境不是你安装包的那个环境
解决方法：
先确认当前是哪个环境：
python -c "import sys; print(sys.executable)"
确认在 organchip 环境中：
conda activate organchip
然后安装：
conda install numpy pandas matplotlib
如果确定当前环境正确但包还是找不到，用 python -m pip 安装：
python -m pip install numpy
python -m pip 能确保 pip 安装到当前这个 Python 对应的环境中。
错误 3：pip 装了包但还是找不到
原因： pip 和 python 可能不是同一个环境。
检查两个命令分别指向哪里：
where python
where pip
macOS / Linux 使用：
which python
which pip
如果路径不一致，说明 pip 安装的包和 Python 运行的环境不匹配。
统一使用这个方式安装：
python -m pip install opencv-python
错误 4：VS Code 运行的不是 organchip 环境
诊断： 新建脚本运行：
import sys
print(sys.executable)
如果路径中不包含 organchip，说明 VS Code 使用了其他环境。
解决： 按 Ctrl + Shift + P → Python: Select Interpreter，重新选择 organchip 环境中的 python.exe（路径参考前面的教程页面）。
错误 5：matplotlib 中文乱码
matplotlib 默认字体通常不包含中文，所以图表中的中文标签会显示为方框。
如果你的图表最终要用 Adobe Illustrator 后期编辑，建议优先使用英文标注。
如果必须用中文，可以设置：
import matplotlib.pyplot as plt
plt.rcParams["font.sans-serif"] = ["SimHei"]
plt.rcParams["axes.unicode_minus"] = False
注意：SimHei 字体在 Windows 上常见，但在 macOS / Linux 上不一定有。不同系统上可用字体不同，可以根据实际字体名称替换。
错误 6：base 环境装乱了怎么办
不要急着卸载重装 Miniconda。先试试创建一个干净的新环境：
conda create -n organchip-clean python=3.11
conda activate organchip-clean
conda install numpy pandas matplotlib scipy scikit-learn openpyxl
pip install opencv-python
绝大多数"环境混乱"问题，都可以通过创建新环境来解决。
错误 7：网络慢或下载失败
- 换一个网络环境重试（例如从宿舍网络换到实验室网络）
- 等几分钟后重试，不要反复打断正在进行的安装
- 下载失败时 conda 和 pip 一般不会损坏已安装的包
不建议新手一开始就配置 conda 国内镜像源。镜像有时同步不全，可能导致更难排查的问题。先用默认源，如果网络确实不行再考虑。
错误 8：权限不足
如果安装路径在 C:\Program Files\，可能出现权限问题。
解决：卸载后重装到用户目录：
C:\Users\你的用户名\miniconda3
最小排查流程
遇到任何报错，按以下步骤排查：
- 打开 Anaconda Prompt
- 激活环境：
conda activate organchip
- 查看 Python 路径：
python -c "import sys; print(sys.executable)"
- 查看已安装的包：
conda list
- 如果缺包，安装：
conda install numpy pandas matplotlib
- 再运行你的代码
大多数问题在前 3 步就能找到原因。