大恒工业相机 Windows 从零配置Python3.14环境 运行官方例程
- 一、前言
- 二、第一步：下载并安装Python（电脑未安装的情况）
- 1. 下载Python安装包
- 2. 安装Python及必要的依赖（关键步骤，必看）
- 3. 验证Python是否安装成功
- 4.安装pip
- 5.安装 numpy 库
- 三、第二步：确认大恒SDK与例程路径（前提：已装大恒相机驱动+SDK）
- 五、第四步：运行大恒官方Python例程（核心步骤）
- 1. 关闭大恒上位机（必做）
- 2. 在CMD中切换到官方例程目录
- 3. 运行官方例程
- 六、常见报错及解决方法（新手必看）
- 报错1：'python' 不是内部或外部命令
- 报错2：No module named 'numpy'
- 报错3：运行python GxSimpleGrab.py报错No module named ‘numpy.compat’
- 报错3：未检测到相机、设备打开失败
- 七、总结
一、前言
本文全程从零开始，适用于电脑未安装Python、想要运行大恒工业相机官方自带Python示例的新手，步骤详细、无遗漏，无需复杂操作，跟着做就能成功跑通相机取图。
核心流程：安装Python → 配置环境 → 安装依赖 → 找到大恒官方例程 → 运行代码
二、第一步：下载并安装Python（电脑未安装的情况）
注：本篇是讲解3.14的安装，其他老点的版本是一样的方法，更容易安装不容易出错，直接看大恒安装目录下的说明配置即可
1. 下载Python安装包
官网下载地址：https://www.python.org/downloads/windows/
下载步骤：打开官网 → 找到“Python 3.14.4”版本 → 点击“Windows Installer (64-bit)”下载（根据自己电脑系统选择，一般都是64位）。
2. 安装Python及必要的依赖（关键步骤，必看）
双击下载好的安装包，弹出安装界面；
最上方勾选【Add Python 3.10 to PATH】（重中之重！勾选后自动配置环境变量，不用手动操作）；
点击【Install Now】（默认安装，无需修改路径，安装位置系统自动分配）；
等待安装完成（约1-2分钟），安装成功后点击【Close】关闭界面。
3. 验证Python是否安装成功
按下键盘【Win+R】，输入“cmd”，按下回车，打开命令提示符（CMD）；
在CMD中输入命令：python（注意空格）；
若显示“Python 3.14.4”，说明安装+环境变量配置成功；
4.安装pip
打开pip网址:https://pip.pypa.io/en/stable/installation/ ，获取 get-pip.py。我是先新建了一个txt改成get-pip.py,再把文件拷贝进去
通过CMD打开DOS命令窗口，切换路径到get-pip.py所在目录。
在DOS命令窗口中输入以下命令完成pip安装。
python get-pip.py- 在系统环境变量中添加pip.exe的路径。
5.安装 numpy 库
在DOS命令窗口中输入以下命令。
pipinstallnumpy==1.26.4三、第二步：确认大恒SDK与例程路径（前提：已装大恒相机驱动+SDK）
- 大恒SDK默认安装路径（一般在C盘）：
C:\Program Files\Daheng Imaging\GalaxySDK\Development\Samples\Python
- 打开该路径，确认里面有以下内容（官方自带，无需额外下载）：
- gxipy 文件夹（大恒相机Python核心库，无需安装）；
五、第四步：运行大恒官方Python例程（核心步骤）
1. 关闭大恒上位机（必做）
你可以先连一次GalaxyViewer看相机是否正常，测试完成之后一定要关闭所有大恒相关软件（如GalaxyViewer），避免相机被占用，导致运行失败。
2. 在CMD中切换到官方例程目录
复制自己电脑上的大恒Python例程路径（参考第三步的默认路径）；
在CMD中输入命令：cd /d 路径 （注意：/d不能少，路径替换成自己的实际路径）；
示例命令（如果路径是默认C盘）：
cdC:\Program Files\Daheng Imaging\GalaxySDK\Development\Samples\Python- 按下回车，若未报错，说明已成功进入例程目录。
3. 运行官方例程
在CMD中输入以下命令，按下回车：
python GxSimpleGrab.py- 运行成功后，会枚举到相机，按键盘【a】开始采集
六、常见报错及解决方法（新手必看）
报错1：‘python’ 不是内部或外部命令
解决办法：
法1：安装Python时未勾选【Add Python to PATH】，重装Python并勾选该选项，重启CMD后重试:
法2：手动把python.exe所在目录增加到环境变量方法
报错2：No module named ‘numpy’
解决：重新执行第二步的5条pip安装命令，确保网络正常，安装完成后重试。
报错3：运行python GxSimpleGrab.py报错No module named ‘numpy.compat’
解决办法：
- 先卸载新版本的numpy(直接按照官方说明书装老版本的python和pip不会装上很新的numpy，就不会报这个错)
pip unintasll-ynumpy2.再安装老版本
pipinstallnumpy==1.26.4报错3：未检测到相机、设备打开失败
解决：1. 关闭所有大恒上位机软件；2. 重新插拔相机USB线，确保连接正常；3. 检查相机驱动（设备管理器中无黄色感叹号）。
七、总结
本文全程从零开始，无需提前安装Python、无需手动配置复杂环境，新手可直接跟着操作；
利用大恒SDK自带的gxipy库和示例代码，无需额外下载、无需修改代码，直接运行即可；
先跑通官方例程，后续可基于官方代码修改，实现自主二次开发。
本文收录于专栏： ✅ 大恒相机·使用操作篇
后续我会持续更新，觉得有用可以收藏+关注，持续更新大恒相机实战内容，新手少走弯路、快速入门。
