Ubuntu 20.04 上 Geant4 安装避坑全记录从源码编译到 B1 示例跑通在粒子物理模拟领域Geant4 作为一款开源的蒙特卡罗模拟工具包被广泛应用于高能物理、医学物理和空间科学等研究领域。然而对于初次接触 Geant4 的科研人员和学生来说在 Ubuntu 系统上从源码编译安装 Geant4 往往伴随着各种坑——从复杂的依赖关系到漫长的数据包下载从晦涩的 CMake 参数到环境变量配置的陷阱。本文将基于笔者在多个科研项目中的实战经验系统梳理这些常见问题的解决方案。1. 环境准备与依赖安装1.1 系统基础环境检查在开始安装前建议先执行以下命令更新系统sudo apt update sudo apt upgrade -y检查关键工具链是否安装g --version cmake --version如果未安装使用sudo apt install g cmake安装基础编译环境。1.2 依赖库的精准安装原始教程中建议的qt4*和qt5*通配安装方式存在两个问题会安装大量不必要的包可能引起版本冲突更精准的依赖安装方案sudo apt install -y \ qtbase5-dev \ qtchooser \ qt5-qmake \ qtbase5-dev-tools \ libx11-dev \ libxext-dev \ libxtst-dev \ libxrender-dev \ libxmu-dev \ libxmuu-dev \ libhdf5-dev \ libexpat1-dev注意Ubuntu 20.04 默认使用 Qt5建议不要混合安装 Qt4 和 Qt5 的开发包2. 源码编译的进阶技巧2.1 CMake 参数深度解析编译 Geant4 时CMake 参数的选择直接影响最终功能和使用体验。以下是关键参数说明参数推荐值作用说明GEANT4_USE_OPENGL_X11ON启用 X11 下的 OpenGL 可视化GEANT4_USE_QTON启用 Qt 界面支持GEANT4_BUILD_MULTITHREADEDON启用多线程支持CMAKE_INSTALL_PREFIX自定义路径指定安装目录GEANT4_INSTALL_DATAON启用数据包自动下载优化后的编译命令示例cmake -DCMAKE_INSTALL_PREFIX$HOME/geant4/geant4-install \ -DGEANT4_USE_OPENGL_X11ON \ -DGEANT4_USE_QTON \ -DGEANT4_BUILD_MULTITHREADEDON \ -DGEANT4_INSTALL_DATAOFF \ ../geant4.10.07.p032.2 多线程编译的最佳实践make -jN中的 N 值设置需要权衡太小编译速度慢太大可能耗尽内存推荐公式N CPU核心数 × 1.5查看 CPU 核心数nproc对于 8 核 CPU推荐make -j12提示编译过程中如果出现内存不足可尝试降低并行度或增加 swap 空间3. 数据包的高效安装方案3.1 国内镜像加速下载官方数据包下载慢的替代方案清华大学镜像站wget https://mirrors.tuna.tsinghua.edu.cn/geant4/data/geant4.10.07.p03/data.tar.gz中科大镜像站wget https://mirrors.ustc.edu.cn/geant4/data/geant4.10.07.p03/data.tar.gz3.2 手动安装数据包的完整流程创建数据目录mkdir -p $HOME/geant4/geant4-install/share/Geant4-10.7.3/data解压数据包tar xzvf data.tar.gz -C $HOME/geant4/geant4-install/share/Geant4-10.7.3/data验证数据完整性ls $HOME/geant4/geant4-install/share/Geant4-10.7.3/data | wc -l应显示 12 个数据目录4. 环境配置与问题排查4.1 .bashrc 配置的常见陷阱典型错误配置# 错误示例路径写死版本号 source ~/geant4/geant4-install/share/Geant4-10.7.3/geant4make/geant4make.sh改进方案使用通配符适配版本变化# 正确示例 source ~/geant4/geant4-install/bin/geant4.sh source ~/geant4/geant4-install/share/Geant4-*/geant4make/geant4make.sh4.2 常见问题诊断问题1运行示例时提示找不到库解决方案sudo ldconfig source ~/.bashrc问题2Qt 界面无法启动检查项确认安装了正确的 Qt 开发包检查 DISPLAY 环境变量尝试远程连接时确保 X11 转发5. B1 示例测试与扩展5.1 完整测试流程cd $HOME/geant4/geant4.10.07.p03/examples/basic/B1 mkdir build cd build cmake .. make -j$(($(nproc)*3/2)) ./exampleB15.2 测试结果验证正常运行的标志弹出 Qt 可视化窗口终端输出类似Run 0 starts... Run 0 ends.5.3 性能优化建议调整线程数./exampleB1 -m 4 # 使用4个线程关闭可视化提升性能./exampleB1 --batch在多个项目实践中最常遇到的坑是环境变量配置不当导致命令找不到。有一次在集群上安装时因为忽略了ldconfig步骤导致团队浪费了半天时间排查。后来我们养成了在安装后立即运行ldconfig的习惯。
Ubuntu 20.04 上 Geant4 安装避坑全记录：从源码编译到 B1 示例跑通（含数据包加速下载）
发布时间：2026/5/30 16:48:24
Ubuntu 20.04 上 Geant4 安装避坑全记录从源码编译到 B1 示例跑通在粒子物理模拟领域Geant4 作为一款开源的蒙特卡罗模拟工具包被广泛应用于高能物理、医学物理和空间科学等研究领域。然而对于初次接触 Geant4 的科研人员和学生来说在 Ubuntu 系统上从源码编译安装 Geant4 往往伴随着各种坑——从复杂的依赖关系到漫长的数据包下载从晦涩的 CMake 参数到环境变量配置的陷阱。本文将基于笔者在多个科研项目中的实战经验系统梳理这些常见问题的解决方案。1. 环境准备与依赖安装1.1 系统基础环境检查在开始安装前建议先执行以下命令更新系统sudo apt update sudo apt upgrade -y检查关键工具链是否安装g --version cmake --version如果未安装使用sudo apt install g cmake安装基础编译环境。1.2 依赖库的精准安装原始教程中建议的qt4*和qt5*通配安装方式存在两个问题会安装大量不必要的包可能引起版本冲突更精准的依赖安装方案sudo apt install -y \ qtbase5-dev \ qtchooser \ qt5-qmake \ qtbase5-dev-tools \ libx11-dev \ libxext-dev \ libxtst-dev \ libxrender-dev \ libxmu-dev \ libxmuu-dev \ libhdf5-dev \ libexpat1-dev注意Ubuntu 20.04 默认使用 Qt5建议不要混合安装 Qt4 和 Qt5 的开发包2. 源码编译的进阶技巧2.1 CMake 参数深度解析编译 Geant4 时CMake 参数的选择直接影响最终功能和使用体验。以下是关键参数说明参数推荐值作用说明GEANT4_USE_OPENGL_X11ON启用 X11 下的 OpenGL 可视化GEANT4_USE_QTON启用 Qt 界面支持GEANT4_BUILD_MULTITHREADEDON启用多线程支持CMAKE_INSTALL_PREFIX自定义路径指定安装目录GEANT4_INSTALL_DATAON启用数据包自动下载优化后的编译命令示例cmake -DCMAKE_INSTALL_PREFIX$HOME/geant4/geant4-install \ -DGEANT4_USE_OPENGL_X11ON \ -DGEANT4_USE_QTON \ -DGEANT4_BUILD_MULTITHREADEDON \ -DGEANT4_INSTALL_DATAOFF \ ../geant4.10.07.p032.2 多线程编译的最佳实践make -jN中的 N 值设置需要权衡太小编译速度慢太大可能耗尽内存推荐公式N CPU核心数 × 1.5查看 CPU 核心数nproc对于 8 核 CPU推荐make -j12提示编译过程中如果出现内存不足可尝试降低并行度或增加 swap 空间3. 数据包的高效安装方案3.1 国内镜像加速下载官方数据包下载慢的替代方案清华大学镜像站wget https://mirrors.tuna.tsinghua.edu.cn/geant4/data/geant4.10.07.p03/data.tar.gz中科大镜像站wget https://mirrors.ustc.edu.cn/geant4/data/geant4.10.07.p03/data.tar.gz3.2 手动安装数据包的完整流程创建数据目录mkdir -p $HOME/geant4/geant4-install/share/Geant4-10.7.3/data解压数据包tar xzvf data.tar.gz -C $HOME/geant4/geant4-install/share/Geant4-10.7.3/data验证数据完整性ls $HOME/geant4/geant4-install/share/Geant4-10.7.3/data | wc -l应显示 12 个数据目录4. 环境配置与问题排查4.1 .bashrc 配置的常见陷阱典型错误配置# 错误示例路径写死版本号 source ~/geant4/geant4-install/share/Geant4-10.7.3/geant4make/geant4make.sh改进方案使用通配符适配版本变化# 正确示例 source ~/geant4/geant4-install/bin/geant4.sh source ~/geant4/geant4-install/share/Geant4-*/geant4make/geant4make.sh4.2 常见问题诊断问题1运行示例时提示找不到库解决方案sudo ldconfig source ~/.bashrc问题2Qt 界面无法启动检查项确认安装了正确的 Qt 开发包检查 DISPLAY 环境变量尝试远程连接时确保 X11 转发5. B1 示例测试与扩展5.1 完整测试流程cd $HOME/geant4/geant4.10.07.p03/examples/basic/B1 mkdir build cd build cmake .. make -j$(($(nproc)*3/2)) ./exampleB15.2 测试结果验证正常运行的标志弹出 Qt 可视化窗口终端输出类似Run 0 starts... Run 0 ends.5.3 性能优化建议调整线程数./exampleB1 -m 4 # 使用4个线程关闭可视化提升性能./exampleB1 --batch在多个项目实践中最常遇到的坑是环境变量配置不当导致命令找不到。有一次在集群上安装时因为忽略了ldconfig步骤导致团队浪费了半天时间排查。后来我们养成了在安装后立即运行ldconfig的习惯。
相关文章
Keil C编译器运行时库中断问题分析与优化
1. 关于Keil C编译器运行时库中断问题的深度解析 在嵌入式开发领域，Keil C编译器（包括C51、C251和C166系列）是许多工程师的首选工具。最近遇到一个典型案例：某工程师在使用sin()函数时发现中断延迟异常增大，怀疑运行时…
BarrageGrab：解决多平台直播数据实时采集的3大挑战与1个创新方案
BarrageGrab：解决多平台直播数据实时采集的3大挑战与1个创新方案 【免费下载链接】BarrageGrab 抖音快手bilibili直播弹幕wss直连，非系统代理方式，无需多开浏览器窗口 项目地址: https://gitcode.com/gh_mirrors/ba/BarrageGrab 在直播…
保姆级教程：用ArcGIS Pro处理复旦10米建筑高度数据（从下载到出图）
从零掌握ArcGIS Pro建筑高度数据处理全流程 第一次接触复旦10米建筑高度数据集时，我被那些分散的TIF瓦片文件搞得晕头转向。作为城市规划师，我们需要的不只是原始数据，而是能直接用于分析的成品。本文将带你完整走通从数据下载到专题图输出的…
如何快速实现Android设备安全检测：4层级完整性验证完整指南
如何快速实现Android设备安全检测：4层级完整性验证完整指南 【免费下载链接】play-integrity-checker-app Get info about your Device Integrity through the Play Intergrity API 项目地址: https://gitcode.com/gh_mirrors/pl/play-integrity-checker-app …
制造业数字化转型：增材制造、协同网络与数据驱动变革
1. 项目概述：一次关于未来制造的深度观察 2017年，我受邀参加了在美国波士顿举办的“指数制造峰会”。这个标题——“Additive, collaborative and connected — 11 takeaways from Exponential Manufacturing 2017”——精准地概括了我从那次峰会带回来的…
手把手教你用Verilog搭建一个简易的AHB2APB桥（附代码与仿真）
从零构建AHB2APB桥：Verilog实战指南与仿真解析 1. AMBA总线系统概述 在复杂的SoC设计中，总线架构如同城市的交通网络，负责高效连接各个功能模块。AMBA（Advanced Microcontroller Bus Architecture）作为ARM公司推出的片…
别再只用rand()了！C++标准库的std::mt19937才是生成随机数的正确姿势
告别rand()时代：用C标准库的std::mt19937打造专业级随机数引擎在游戏开发中生成敌人属性时，你是否遇到过玩家抱怨"这个BOSS的暴击率绝对有问题"？在抽奖算法测试中，是否发现某些奖品被抽中的频率异常偏高？这些…
硬件调试革命：3大技术突破让AMD系统稳定性提升5倍
硬件调试革命：3大技术突破让AMD系统稳定性提升5倍 【免费下载链接】SMUDebugTool A dedicated tool to help write/read various parameters of Ryzen-based systems, such as manual overclock, SMU, PCI, CPUID, MSR and Power Table. 项目地址: https://gitcod…
ncmdump终极指南：解锁网易云音乐加密格式，实现音乐自由播放
ncmdump终极指南：解锁网易云音乐加密格式，实现音乐自由播放 【免费下载链接】ncmdump 项目地址: https://gitcode.com/gh_mirrors/ncmd/ncmdump 你是否曾在网易云音乐下载了心爱的歌曲，却发现只能在官方客户端播放？当你试…
Win11/Win10深度学习环境搭建：实测PyCharm远程连接WSL2下的CUDA，性能比虚拟机强多少？
Win11/Win10深度学习环境终极对决：WSL2 CUDA vs 虚拟机 vs 双系统实测指南当开发者需要在Windows系统上进行深度学习开发时，通常会面临三种选择：虚拟机方案、双系统方案和WSL2方案。本文将基于实际测试数据，从GPU性能、开发便利性…
SketchUp STL插件终极指南：3D打印工作流完全掌握
SketchUp STL插件终极指南：3D打印工作流完全掌握 【免费下载链接】sketchup-stl A SketchUp Ruby Extension that adds STL (STereoLithography) file format import and export. 项目地址: https://gitcode.com/gh_mirrors/sk/sketchup-stl SketchUp STL插件…
基于ICL8038的多波形信号发生器：从原理到制作的完整指南
1. 项目概述：从零构建一个基于ICL8038的多波形信号发生器在电子实验、设备调试乃至生物医学信号处理领域，一个稳定可靠、波形纯净的信号源是不可或缺的“心脏”。无论是用于测试放大器的频率响应，还是模拟生理电信号进行算法研究，…
施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录
更多请点击： https://codechina.net 第一章：施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录 在华北某大型地铁盾构施工现场，一套轻量化AI Agent系统于2024年Q2完成全栈部署ÿ…
附录 B：术语表
本术语表面向“从 MM 到 HMM”专栏阅读过程中的快速查阅。它不是内核 API 手册，而是把文章中反复出现的概念放到同一张地图上：先给出直观含义，再说明它在 Linux MM/HMM 语境里的作用。建议阅读方式： 初读专栏时，把它当…
Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表·行业首曝）
更多请点击： https://kaifayun.com 第一章：Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表行业首曝） Midjourney 的渐变美学并非传统插值实现，而是由其隐式神经渲染器（Implicit Neu…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…