安装

环境要求

Python >= 3.10
NumPy >= 1.20.0
支持 OpenMP 的 Fortran 编译器（gfortran >= 9），用于构建原生后端

安装（源码构建）

CNCHASH 2.x 是源码安装包：原生后端需要用 CMake 编译一次。

git clone https://github.com/Chuan1937/CNCHASH.git
cd CNCHASH

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

# 可选：本机性能版（约快 2.5 倍，仅限当前机器）
# cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCNCHASH_NATIVE_MARCH=ON

export CNCHASH_HASHHP_LIB=$PWD/build/libhashhp.so
pip install -e .

包会自动检测 libhashhp（也可通过 CNCHASH_HASHHP_LIB 显式指定）。

开发环境

pip install -e ".[dev]"
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

验证安装

from cnchash import run_hash, get_backend_info
print(get_backend_info())

get_backend_info() 报告后端类型、OpenMP 线程数和库路径。如果没有编译原生库，会给出明确的构建错误提示。