Windows下安装pydicom超详细教程(小白从零上手版)
处理医学影像文件时,经常会碰到DICOM格式。pydicom是Python里专门用来读取、修改、写入DICOM文件的库,免费开源,功能够用且稳定。很多影像AI项目、医院数据处理脚本都依赖它。今天这篇就手把手教你在Windows系统下把pydicom装好,哪怕你是完全没接触过Python的新手,也能跟着一步步完成。
安装前必须先搞定的准备
pydicom是Python库,所以电脑里得先有Python环境。没有的话,所有命令都会报错。
1. 检查有没有Python
按键盘 Win + R,输入 cmd 回车,打开黑色命令窗口。
输入下面这行再回车:
python --version
如果显示类似 Python 3.10.11 或 Python 3.11.x 的版本号,说明已经装过,直接跳到下一步。
如果提示“不是内部或外部命令”,那就需要先装Python。
2. 下载并安装Python(没装的才看)
去Python官网下载页面,选最新的稳定版(推荐3.10或3.11,兼容性最好)。下载Windows installer (64-bit)。
双击安装包后注意两点:
- 勾选底部的 “Add Python to PATH”(非常关键,不勾后面pip会找不到)
- 选 “Install Now”
装完后重新打开cmd,再输入 python --version 确认成功。
3. 确认pip能用
pip是Python的包管理工具,装库全靠它。在cmd里输入:
pip --version
正常会显示pip版本和路径。如果提示找不到,先升级一下:
python -m ensurepip --upgrade
或
python -m pip install --upgrade pip
正式安装pydicom(三种常用方法)
方法一:最简单直接装(推荐新手)
打开cmd(建议右键“以管理员身份运行”,避免权限问题),直接输入:
pip install pydicom
回车后会自动下载并安装。看到 “Successfully installed pydicom-x.x.x” 就成功了。
整个过程通常几十秒,网络好的话更快。
方法二:指定国内镜像加速(网络慢或超时就用这个)
有时默认源下载很慢甚至失败,换成国内镜像:
pip install pydicom -i https://pypi.tuna.tsinghua.edu.cn/simple
或者阿里云:
pip install pydicom -i https://mirrors.aliyun.com/pypi/simple/
其他可用镜像还有豆瓣、中科大,效果一样。
方法三:装到虚拟环境里(项目多的时候更干净)
不想污染系统Python,可以建虚拟环境。
先建环境:
python -m venv pydicom_env
激活环境(Windows):
pydicom_env\Scripts\activate
看到命令行前面出现 (pydicom_env) 就表示激活成功。
然后正常装:
pip install pydicom
以后用的时候先激活这个环境再运行代码。退出环境输入 deactivate 即可。
验证安装是否成功
装完别急着关窗口,直接测试:
python -c "import pydicom; print(pydicom.__version__)"
如果输出类似 2.4.4 或当前最新版本号,说明导入正常,安装完成。
也可以写个小测试脚本:新建一个txt文件,改后缀为 .py,内容写:
import pydicom
print("pydicom安装成功,版本:", pydicom.__version__)
双击运行或在cmd里用 python 你的文件名.py,能打印出版本就没问题。
常见报错与解决办法
1. “pip不是内部或外部命令”
说明Python没加到PATH。重新安装Python并勾选Add to PATH,或者手动把Python安装目录和Scripts目录加到系统环境变量Path里。
2. 权限不足 / Access denied
用管理员身份打开cmd再执行安装命令。或者加参数:
pip install pydicom --user
只装当前用户,不需要管理员权限。
3. 网络超时、连接失败
换国内镜像(上面方法二),或者多试几次。公司网络有代理的话,先关掉代理再装。
4. 提示需要更高版本的Python
pydicom目前支持Python 3.7及以上。版本太低就升级Python,或者用:
pip install pydicom==2.3.1
装一个兼容旧版本的稳定版。
5. 装完import报错 ModuleNotFoundError
检查是不是装到了别的Python环境。用 where python 和 where pip 看路径是否一致。不一致就用完整路径安装:
C:\Python311\python.exe -m pip install pydicom
安装后的实用建议
装好后建议顺手装两个常一起用的库:
pip install numpy matplotlib
numpy用来处理像素数据,matplotlib方便直接显示影像。
读DICOM文件时,简单示例代码:
import pydicom
ds = pydicom.dcmread("你的文件.dcm")
print(ds.PatientName) # 看病人姓名
print(ds.pixel_array.shape) # 看图像尺寸
文件路径记得换成自己的实际路径。
Windows下有时候会遇到中文路径乱码,尽量把DICOM文件放到纯英文路径下再读取。
如果以后要处理大批量文件或做AI训练,建议把环境用虚拟环境或conda管理,方便迁移和复现。
到这里,Windows下安装pydicom的完整流程就结束了。按照上面步骤走,基本都能一次成功。装好后就可以开始读医学影像、改标签、导出数据了。

还没有评论,来说两句吧...