正确安装命令是pip install scikit-image（带连字符），导入时用import skimage（全小写无连字符）；报错主因是安装名与导入名混淆或Python/pip环境不一致，Linux还需预装系统依赖如libjpeg-dev等。
直接用 pip install scikit-image 就能装好，但 90% 的报错都出在「名字写错」或「环境没对上」。
pip install skimage 为什么报错 ModuleNotFoundError
因为 PyPI 上根本不存在叫 skimage 的包——只有 scikit-image（带连字符）。你输 pip install skimage，pip 会去搜一个不存在的包，安装失败；之后再 import skimage，自然就报 ModuleNotFoundError: No module named 'skimage'。
- ✅ 正确安装命令：
pip install scikit-image - ❌ 错误安装命令：
pip install skimage、pip install scikit_image、pip install scikitimage - ⚠️ 导入时永远是
import skimage（无连字符、全小写），不是import scikit-image（语法错误）
装完 import skimage 还报错？先查 Python 和 pip 是不是同一个环境
常见于多 Python 版本共存（比如系统自带 Python + Anaconda + pyenv）、或用了虚拟环境但没激活。运行 which python（macOS/Linux）或 where python（Windows），再运行 which pip 或 where pip，两个路径必须一致。
- 如果用 conda 环境：先
conda activate myenv，再pip install scikit-image - 如果用 venv：确保已执行
source venv/bin/activate（Linux/macOS）或venv\Scripts\activate（Windows） - 验证是否装对了：在 Python 交互环境中执行
import skimage; print(skimage.__version__)，能输出版本号才算成功
Linux 下 pip install scikit-image 卡住或编译失败
scikit-image 依赖 numpy、scipy、pillow，其中 scipy 在 Linux 上默认要编译，缺系统级头文件就会失败。报错常含 fatal error: Python.h 或 libjpeg-dev not found。
- Ubuntu/Debian 先装依赖：
sudo apt-get install python3-dev libjpeg-dev libpng-dev libtiff-dev - CentOS/RHEL：
sudo yum install python3-devel libjpeg-devel libpng-devel libtiff-devel - 装完再跑
pip install scikit-image；如果仍慢，可加--only-binary=all强制用预编译 wheel：pip install --only-binary=all scikit-image
验证安装后 import skimage.io 报 AttributeError
说明安装看似成功，但实际模块没加载全——常见于旧版 scikit-image 与新版 numpy 不兼容（比如 scikit-image==0.19 跑在 numpy>=2.0 上）。当前（2026 年）推荐用 scikit-image>=0.22，它原生支持 numpy 2.x 和 Python 3.9–3.13。
- 检查版本：
pip show scikit-image numpy - 升级到兼容版：
pip install -U scikit-image - 若因项目约束必须用老版
scikit-image，则降级numpy：pip install "numpy
最常被忽略的一点：装完别只测试 import skimage，一定要试一句 from skimage import io 或 skimage.data.coins()——很多“安装成功”只是顶层包导入通了，子模块实际缺失或损坏。
