hipInit() 调用失败主因是找不到 libamdhip64.so，需确认 ROCm 安装、设置 LD_LIBRARY_PATH 或 /etc/ld.so.conf.d/、检查内核与 GPU 兼容性，并确保正确链接 -lamdhip64。
hipInit() 调用失败：找不到 libamdhip64.so
直接运行 hipInit(0) 报错 “HIP_ERROR_INVALID_VALUE” 或段错误，大概率是运行时找不到 HIP 运行时库。HIP 不是纯头文件库，它依赖 AMD 提供的 libamdhip64.so（Linux）或 amdhip64.dll（Windows），这个库由 ROCm 安装提供，但不会自动加入系统动态库路径。
- 确认 ROCm 已安装且版本匹配：运行
hipconfig，若提示 command not found，说明没装或没 source 环境变量 - 检查库是否存在：
find /opt/rocm -name "libamdhip64.so" 2>/dev/null；常见路径是/opt/rocm/lib/libamdhip64.so - 临时生效：运行前执行
export LD_LIBRARY_PATH=/opt/rocm/lib:$LD_LIBRARY_PATH - 永久生效：把
/opt/rocm/lib加进/etc/ld.so.conf.d/rocm.conf，再跑sudo ldconfig - 注意：ROCm 5.7+ 默认只支持 Linux 5.10+ 内核和特定 GPU 架构（如 gfx90a/gfx1100），老卡（如 Fiji、Polaris）不被支持
hipMemcpyAsync 在 host-to-device 时卡住或返回 hipErrorInvalidValue
hipMemcpyAsync 不像 CUDA 的 cudaMemcpyAsync 那样“默认可用”，它要求目标内存必须是 pinned（页锁定）内存，否则会静默失败或返回错误码。这是最常踩的坑——你传了普通 malloc 分配的指针，HIP 却不报明确错误，只返回 hipErrorInvalidValue。
- host 端必须用
hipHostMalloc()分配内存，不能用new或malloc - device 端用
hipMalloc()，和 CUDA 一致 - 同步流：确保调用
hipStreamSynchronize(stream)或hipDeviceSynchronize()，否则 memcpy 可能还没真正发生 - 示例片段：
void *h_src, *d_dst; hipHostMalloc(&h_src, size); // 关键 hipMalloc(&d_dst, size); hipMemcpyAsync(d_dst, h_src, size, hipMemcpyHostToDevice, stream);
编译时报错 undefined reference to `hipLaunchKernel' 或 ‘hipGetErrorString’
链接阶段失败，不是头文件没包含，而是没链接 HIP 运行时库。HIP 的 C++ 接口（hip_runtime.h）是头文件，但所有符号实现在 libamdhip64.so 中，CMake 或 g++ 命令里漏掉 -lamdhip64 就会炸。
- g++ 命令末尾加
-L/opt/rocm/lib -lamdhip64 -lhip_hcc（ROCm 5.6 及以前需-lhip_hcc；5.7+ 合并进libamdhip64.so，可省略） - CMakeLists.txt 中写：
find_package(hip REQUIRED)+target_link_libraries(myapp PRIVATE hip::host)（推荐，自动处理路径和依赖） - 别用
-lhiprtc替代-lamdhip64：前者是运行时编译器（JIT），后者才是运行时 API - 注意：HIP 头文件路径通常在
/opt/rocm/include/hip，确保-I/opt/rocm/include存在
hipGetDeviceProperties 返回 0 或空字符串，设备数为 0
hipGetDeviceCount() 返回 0，或者 hipGetDeviceProperties() 填出来的 props.name 是空，说明 HIP 没识别到 GPU。这不是代码问题，而是驱动或权限问题。
立即学习“C++免费学习笔记（深入）”；
- 确认
clinfo或rocm-smi能看到设备；如果连这些命令都报错，先解决底层驱动 - 检查内核模块：
lsmod | grep amdgpu必须有输出；若没有，可能未加载或被 nouveau/nvidia 驱动冲突 - 用户需在
video组里：sudo usermod -aG video $USER，然后重新登录 - ROCm 不支持通过 Navi 2x（RDNA2）的 iGPU（如 Ryzen 6000/7000 笔记本 APU），仅支持独立显卡（如 RX 6700 XT、MI210）或服务器卡（MI250X）
- Ubuntu 上某些发行版默认启用安全启动（Secure Boot），会阻止 amdgpu 模块加载，需在 BIOS 中关闭
hipInit() 就只是个返回 0 的函数。很多人卡在第一步却以为是代码写错了。 
