最常用也最容易出错的方式是用 SetBranchAddress 绑定变量地址，因其不自动分配内存、不检查类型匹配，绑错类型或未调用 GetEntry(i) 会导致垃圾值或崩溃。
ROOT 里怎么读取 TTree 的分支数据
直接用 SetBranchAddress 绑定变量地址是最常用也最容易出错的方式。它不自动分配内存，也不检查类型匹配，绑错类型或忘了调用 GetEntry(i) 就会读出垃圾值甚至崩溃。
- 必须确保绑定的变量生命周期覆盖整个循环——局部变量在循环内定义但没用
static或没声明在循环外，下一次迭代地址可能失效 -
Double_t和double、Int_t和int在不同平台可能不等价，优先用 ROOT 自带的类型（如Float_t*接float分支） - 字符串分支（
TClonesArray或TObjArray）不能用简单指针绑定，得用SetBranchAddress("name", &ptr, &b)并手动管理对象创建 - 示例：读一个浮点型分支
energy：Float_t energy;<br>tree->SetBranchAddress("energy", &energy);<br>for (Long64_t i = 0; i < tree->GetEntries(); ++i) {<br> tree->GetEntry(i);<br> // 此时 energy 才更新
为什么 TTree::Draw 画出来是空图
不是语法错，就是树没被正确激活或分支名拼写/大小写不对——ROOT 对分支名严格区分大小写，且不报错，只静默失败。
- 确认树是否已加载：运行
tree->Print()看输出里有没有目标分支；没出现说明文件损坏、路径错，或分支名带空格/特殊字符（需用引号包裹，如"muon_pt"） -
Draw默认只画前 1000 个事件，大数据量时看起来像没画——加""强制全画，或显式指定范围：tree->Draw("energy", "energy>0", "goff", 100000) - 直方图 bin 数默认是 100，如果变量范围极大（如 GeV 量级能量），bin 宽太大导致所有点堆在第一个 bin——手动设 bin：
tree->Draw("energy>>h1(200,0,2000)") - 交互式环境（如 ROOT CLI）中，
Draw后不显示图形？检查是否漏了gPad->Update()或gROOT->ProcessLine("gStyle->SetOptStat(0);")关闭统计框干扰
C++ 编译时链接 ROOT 库总失败
根本原因不是没装 ROOT，而是没用 ROOT 提供的编译器包装器 root-config 获取正确的 flags，自己硬写 -lCore -lTree 极易漏库或顺序错。
- 正确做法：用
root-config --cflags --libs输出完整编译参数，嵌入 Makefile 或 CMakeLists.txt；CMake 中推荐用find_package(ROOT REQUIRED)+target_link_libraries(myexe ${ROOT_LIBRARIES}) - 常见错误：只连
-lTree却没连-lRIO（TTree 依赖），或在 macOS 上漏-stdlib=libc++导致 STL 类型不兼容 - 调试技巧：运行
ldd your_executable | grep root（Linux）或otool -L your_executable | grep root（macOS），看实际链接了哪些 ROOT 动态库；缺失的就补进链接命令 - 注意 ROOT 6.28+ 默认启用 C++17，若代码用了
std::optional等特性，编译器必须匹配，否则链接时报 undefined symbol
用 ROOT 处理非 ROOT 格式数据（CSV / HDF5）太慢
别硬塞进 TTree——ROOT 不是通用 IO 库。CSV 直接读写用 std::ifstream + std::stod 更快；HDF5 必须用官方 C API 或 h5py Python 转成 ROOT 格式再分析。
立即学习“C++免费学习笔记（深入）”；
- CSV 转 TTree 的合理做法：单次读取 CSV 行，填充一个
TTree::Fill()，但每行 Fill 前要清空分支缓存（尤其数组分支），否则旧数据残留 - HDF5 场景下，ROOT 本身不原生支持；强行用第三方 wrapper（如
rhdf5）容易内存泄漏——更稳的路径是 Python 脚本用h5py读 +uproot写成 ROOT 文件，再用 C++ 分析 - 性能陷阱：在循环里反复调用
tree->Branch("x", &x)（比如每次处理一个新文件）会累积大量 branch 对象，最终 OOM；应复用同一个 TTree，调用tree->ResetBranchAddresses()后重新绑定 - 替代方案：对纯数值计算密集任务（如拟合、矩阵运算），把数据导出为
std::vector或ROOT::Math::Matrix，用 Eigen 或 GSL 加速，比在 TTree 上做Scan快数倍
GetEntry，或者以为 Draw 是万能绘图函数却忽略了它本质是直方图填充器。这些地方不报错，只默默给你错的结果。 
