1. 在aarch64 Linux环境编译安装CinderX的完整指南
最近在aarch64架构的Linux系统上尝试安装CinderX时遇到了一些挑战，由于官方没有提供预编译的whl包，不得不走源码编译这条路。整个过程踩了不少坑，也积累了一些经验，在这里做个完整记录。
1.1 环境准备
首先需要确认系统环境：
- 操作系统：Kylin Linux（基于aarch64架构）
- Python版本：3.14.3
- 编译器：GCC 14.2.0
- 构建工具：CMake 4.2.3
注意：CinderX对Python版本有特定要求，建议使用官方推荐的Python版本。我在测试中使用的是通过uv工具安装的CPython 3.14.3。
1.2 初始尝试与问题发现
最初直接使用pip安装时遇到了第一个问题：
bash复制python3.14 /par/pip.pyz install cinderx -i https://mirrors.aliyun.com/pypi/simple/
错误提示很明显：error: command 'cmake' failed: No such file or directory。这说明系统缺少CMake构建工具。
2. 解决CMake缺失问题
2.1 安装CMake
对于aarch64架构的系统，可以从源码编译安装CMake，或者使用预编译的二进制包。我选择了后者：
bash复制export PATH=/par/cmake-4.2.3-linux-aarch64/bin:$PATH
安装后验证版本：
bash复制cmake --version
2.2 再次尝试编译
设置好CMake路径后重新尝试编译，这次遇到了新的问题：
code复制fatal: unable to access 'https://github.com/fmtlib/fmt/': Proxy CONNECT aborted
这是CMake在尝试从GitHub克隆fmt库时失败了，原因是网络连接问题。
3. 解决依赖下载问题
3.1 手动下载源码
由于pip安装过程无法中断后继续，我决定手动下载源码包：
bash复制curl -LO https://mirrors.aliyun.com/pypi/packages/8f/7f/ee08bad651fc19fcc30a1e2ccfcf39251a85f685321c399ddf5cd04cf6df/cinderx-2026.3.30.0.tar.gz
tar xf cinderx-2026.3.30.0.tar.gz
3.2 修改CMakeLists.txt
为了解决GitHub访问问题，可以修改CMakeLists.txt文件，将GitHub地址替换为国内镜像地址。具体修改位置取决于项目的具体结构。
4. 手动编译过程
4.1 执行CMake命令
使用之前pip尝试时生成的CMake命令进行配置：
bash复制cmake .. DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_LIBRARY_OUTPUT_DIRECTORY=/tmp/pip-install-hzoylwrp/cinderx_084470de0ea74e388b4bb7e030a95dfc/scratch/lib.linux-aarch64-cpython-314 -DCMAKE_C_COMPILER=/usr/local/bin/gcc -DCMAKE_CXX_COMPILER=/usr/local/bin/g++ -DCMAKE_VERBOSE_MAKEFILE:BOOL=OFF -DENABLE_LTO=OFF -DPY_VERSION=3.14 -DPython_ROOT_DIR=/root/.local/share/uv/python/cpython-3.14.3-linux-aarch64-gnu/include/python3.14/../.. -DMETA_PYTHON=0 -DENABLE_ADAPTIVE_STATIC_PYTHON=0 -DENABLE_DISASSEMBLER=0 -DENABLE_ELF_READER=1 -DENABLE_EVAL_HOOK=0 -DENABLE_FUNC_EVENT_MODIFY_QUALNAME=0 -DENABLE_GENERATOR_AWAITER=0 -DENABLE_INTERPRETER_LOOP=1 -DENABLE_LAZY_IMPORTS=0 -DENABLE_LIGHTWEIGHT_FRAMES=0 -DENABLE_PARALLEL_GC=0 -DENABLE_PEP523_HOOK=1 -DENABLE_PERF_TRAMPOLINE=0 -DENABLE_SYMBOLIZER=1 -DENABLE_USDT=1 -B scratch/temp.linux-aarch64-cpython-314 /tmp/pip-install-hzoylwrp/cinderx_084470de0ea74e388b4bb7e030a95dfc
4.2 执行make编译
进入生成的构建目录执行编译：
bash复制cd /par/cinderx-2026.3.30.0/build/scratch/temp.linux-aarch64-cpython-314
make -j 8
编译成功后会在指定目录生成_cinderx.so文件。
5. 生成wheel包并安装
5.1 安装setuptools
尝试生成wheel包时发现缺少setuptools：
bash复制python3.14 setup.py bdist_wheel
安装setuptools：
bash复制python3.14 /par/pip.pyz install setuptools
5.2 生成wheel包
再次执行生成命令：
bash复制python3.14 setup.py bdist_wheel
虽然提示setup.py install is deprecated，但还是成功生成了wheel包。
5.3 安装生成的wheel
bash复制python3.14 /par/pip.pyz install dist/cinderx-2026.3.30.0-cp314-cp314-linux_aarch64.whl
6. 验证安装
安装完成后尝试导入模块：
python复制import cinderx.jit
出现警告信息：
code复制JIT: /par/cinderx-2026.3.30.0/cinderx/Jit/code_allocator.cpp:62 -- Failed to madvise [0x7f8cd5c000, 0x7f8cf5c000) with MADV_HUGEPAGE, errno=22
这与CMake配置时的警告一致：
code复制This CMake build is not well supported, and is primarily used for experimentation. Do not expect this to work on your machine.
7. 经验总结与注意事项
-
架构兼容性问题：aarch64架构下的编译支持可能不完善，官方不提供预编译包通常是有原因的。
-
依赖管理：CMake项目经常需要从网络获取依赖，在国内环境下可能会遇到连接问题，建议提前配置镜像源或手动下载依赖。
-
构建工具链：确保CMake、make等工具版本兼容，特别是对于较新的Python版本。
-
环境隔离：使用虚拟环境（如venv）可以避免污染系统Python环境。
-
错误排查：仔细阅读错误信息，很多情况下错误提示已经包含了解决方案。
-
性能考虑：对于生产环境，建议使用官方支持的平台和架构，避免使用实验性构建。
重要提示：如果只是为了测试或开发目的，可以考虑使用Docker容器来创建兼容的构建环境，而不是直接在主机系统上尝试编译。
虽然最终安装没有完全成功，但这个过程提供了宝贵的经验，特别是在处理aarch64架构下的Python包编译问题。对于需要高性能Python扩展的场景，建议考虑其他更成熟的解决方案，或者等待官方提供对aarch64架构的正式支持。