Geant4 初始化需严格遵循顺序：先构造G4UIbatch或G4UIExecutive，再调用G4UImanager::GetUIpointer()；多线程必须用G4UIbatch；世界体积须最大并首个创建；几何检查用/geometry/test/run；粒子枪须显式设定义、方向与动能；SteppingAction中PreStepPoint可能为空，应优先用PostStepPoint获取体积名。
Geant4 项目怎么初始化才不会在 RunManager 构造时崩溃
Geant4 不是拿来即用的库，它要求严格的初始化顺序。最常见报错是 Segmentation fault (core dumped) 或 Aborted (core dumped)，出现在 new G4RunManager() 这一行——根本原因往往是 G4UIExecutive / G4UImanager 没配好，或者多线程模式和单线程接口混用。
- 必须在
main()开头调用G4UImanager::GetUIpointer()之前，先确保G4UIExecutive（交互式）或G4UIbatch（批处理）已构造完成；否则 UI 系统内部空指针解引用 - 如果不用 GUI，直接走 batch 模式：用
new G4UIbatch("/control/execute init.mac")，再UImanager->ApplyCommand()加载宏文件，别漏掉/run/initialize - 多线程项目（
G4MULTITHREADED定义）不能用G4UIExecutive，必须用G4UIbatch或自定义G4UIsession子类，否则主线程和 worker 线程抢 UI 资源 - 链接时确认
-lG4uiterminal -lG4intercoms已加入（Linux），macOS 上还可能需要-framework Cocoa
探测器几何怎么建才不被 G4PVPlacement 报 “overlap” 或 “out of world”
几何构建失败不是模型画得丑，而是世界体积（World）没包住所有子体积，或物理体积位置/尺寸算错。Geant4 在 G4RunManager::Initialize() 时做一次全局重叠检查，出错就 halt，不给运行机会。
-
G4VPhysicalVolume*的世界体必须是第一个创建、最后一个销毁的，且尺寸要大于等于所有子体积的包围盒；常用写法：new G4PVPlacement(0, G4ThreeVector(), worldLogical, "World", 0, false, 0) - 子体积放置前，务必用
G4VSolid::GetExtent()检查其理论包围盒，再叠加位移判断是否越界；别依赖“目测” - 用
/geometry/test/run命令触发内置几何检查（需启用G4GEOMETRY_DEBUG编译选项），它会输出具体哪两个体积重叠、最小间隙多少 - 布尔运算（
G4UnionSolid等）后，记得调用G4GeometryManager::GetInstance()->OpenGeometry()刷新缓存，否则旧 bounding box 仍生效
粒子怎么发、能量怎么设，才能避开 G4ParticleGun 的常见陷阱
G4ParticleGun 看似简单，但默认构造的枪不带能量、不指定粒子类型、不设位置——运行时要么静止不动，要么报 particle type not defined，甚至悄悄用默认的 gamma 替代你想要的 proton。
- 必须显式调用
SetParticleDefinition(G4Proton::Definition())，不能只靠SetParticleName("proton")（后者仅用于宏命令解析） - 动量方向用
SetParticleMomentumDirection(G4ThreeVector(0,0,1))，不是SetParticleDirection()（后者已被弃用，编译可能过，运行时无效） - 动能 vs 总能：用
SetParticleEnergy(10*MeV)设动能；若误用SetParticleTotalEnergy()，对轻粒子（e.g., e-）会导致动量计算错误，轨迹异常弯曲 - 批量发射多个事件时，每次
GeneratePrimaryVertex()前必须重置枪参数，否则沿用上一次值；建议封装成独立函数，避免状态残留
为什么 G4SteppingAction 里拿不到 PreStepPoint 的能量或体积名
因为 PreStepPoint 在 step 开始时尚未进入新介质，它的 GetMaterial() 和 GetPhysicalVolume() 返回的是上一步终点所在 volume，而 GetKineticEnergy() 是 step 开始前的值——这本身没错，但容易误以为“拿错了”。真正踩坑的是访问时机和空指针。
立即学习“C++免费学习笔记（深入）”；
-
step->GetPreStepPoint()->GetPhysicalVolume()可能返回nullptr（比如刚从世界边界进入某 volume 的第一步），必须判空；同理，GetTouchable()在某些 step 中也不可靠 - 想获取当前 step 所在 volume 名？优先用
step->GetPostStepPoint()->GetPhysicalVolume()->GetName()，更稳定 - 获取沉积能量别用
GetDeltaEnergy()（它是损失，含电离+激发+轫致辐射等），要用step->GetTotalEnergyDeposit()，后者已扣除次级粒子带走的能量 - 若需历史路径（比如从 source 到 hit 的完整 volume 链），必须在
G4TrackingAction中用touchable->GetVolume(i)逐层向上遍历，SteppingAction里没有完整树信息
examples/basic/B1，对照它的 CMakeLists.txt 和 macro 文件，比自己从零搭更快定位问题。 
