本系列文章的运行环境基于CentOS 6.3 x86_64，gcc 5.2.0，cmake version 3.15.0， glibc 2.23.2，后文不再赘述。
LLVM&clang简介
LLVM是一组编译工具链集合，值得注意的是，LLVM并不是谁的缩写，其中的VM与virtual machine也没有关系。如官网所述，LLVM就是这个项目的名称，没有其他含义。
clang（读音/klaNG/，音同可浪）是LLVM的一个子项目(sub-project)。 它是一个C系语言的编译前端，同时clang还提供了以下三种面向开发者的扩展方式：
- C Library libclang ，libclang是一套稳定的(stable)但对AST控制不够全面的C Libray
- C++ Library libtooling，libtooling是一套对AST控制全面但却不够稳定的C++ Library，不稳定指的是无前后兼容保证，接口经常变化（包括函数名称、函数参数列表）
- plugin， C++接口，主要针对单次编译的单个文件，比如可用于实现一个自定义风格的代码检查工具
不同的业务目标，可以在以上三种做出选择，本系列最终目的是完成中大型项目的代码索引，所以选择基于libtooling进行开发。
安装
源码下载
由于libtooling的不稳定因素，我们决定采用最新的LLVM8.0-release版本。
分别下载LLVM源码、clang源码、clang-tools-extra源码并解压。由于LLVM各个工程共享了很多CMake配置，因此需要调整他们的位置，
假设LLVM、clang、clang-tools-extra源码解压后被放置在 LLVM_SRC_ROOT, CLANG_SRC_ROOT,CLANG_TOOLS_EXTRA_ROOT，那么需要进行如下的目录调整
#set these 3 env
export LLVM_SRC_ROOT=/path/to/your/llvm
export CLANG_SRC_ROOT=/path/to/your/cfe #clang-src
export CLANG_TOOLS_EXTRA_ROOT=/path/to/your/clang-tools-extra
#will use 3 env defined above
mv ${CLANG_SRC_ROOT} ${LLVM_SRC_ROOT}/tools/clang
mv ${CLANG_TOOLS_EXTRA_ROOT} ${LLVM_SRC_ROOT}/tools/clang/tools/extra
使用ln -s TARGET LINK的方式建立两个软链也可达到类似的收益。
除了上面的方式，官方提供了cmake 宏 LLVM_ENABLE_PROJECTS，可以不将clang等源码目录移动到llvm下:
- 将clang解压至
${LLVM_SRC_ROOT}/..，即llvm-src的平级目录, 命名为clang- 将extra-tool也解压到llvm平级目录，命名为clang-tools-extra
- 在${LLVM_SRC_ROOT}/build下，
cmake -DLLVM_ENABLE_PROJECTS=clang -G "Unix Makefiles" .., 这时， LLVM_TOOL_CLANG_TOOLS_EXTRA_BUILD 会被设置成ON，继续编译:make clang && make clangd。
编译安装
先决条件
最新的LLVM需要CMake. Version 3.4.3，下文假设合适版本的cmake已经正确安装，此外编译LLVM，最好磁盘剩余80G以上空间。
编译前空间:
$ df -h
Filesystem Size Used Avail Use% Mounted on
/dev/vda1 20G 5.0G 14G 28% /
tmpfs 7.8G 11M 7.8G 1% /dev/shm
/dev/vdb 233G 8.6G 212G 4% /home
编译后剩余空间:
$ df -h
Filesystem Size Used Avail Use% Mounted on
/dev/vda1 20G 5.0G 14G 28% /
tmpfs 7.8G 11M 7.8G 1% /dev/shm
/dev/vdb 233G 82G 139G 38% /home
粗略的空间估算, 由于进行的是LLVM全系列编译，硬盘消耗约80G, 如没有如此多的空间，可根据需要只编译某一部分，比如 在cmake build时，仅执行make clang。
假设CMake和CXX(比如g++)是工作的，直接按照官方文档编译即可, 编译比较耗时，为了加速，可以设置-j并发参数,参考如下build命令的注释内容，即使加速，也需要小时级别耗时（视机器配置和负荷有所不同）。
cd ${LLVM_SRC_ROOT}
mkdir -p build
cd build
cmake ${LLVM_SRC_ROOT}
CPU_NUM=`getconf _NPROCESSORS_ONLN`
cmake --build . # to speed up , -j <num> is recommended, say : cmake --build . -j ${CPU_NUM} || cmake --build .
#if compile successfully, install
cmake -DCMAKE_INSTALL_PREFIX=/path/where/llvm/installed -P cmake_install.cmake
如以上均正确返回，再double check一下，环境变量等是否正确
$ clang++ --version
clang version 8.0.0 (tags/RELEASE_800/final)
Target: x86_64-unknown-linux-gnu
Thread model: posix
InstalledDir: /home/M23/local/llvm/bin
检查一下LLVM的某项配置：
$ llvm-config --cxxflags
-I/home/M23/local/llvm/include -std=c++11 -fno-exceptions -fno-rtti -D_GNU_SOURCE -D_DEBUG -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -D__STDC_LIMIT_MACROS
在上面的步骤中，我们还下载了clang-tools-extra， 如果需要编译clangd等extra-tool， 则需要在cmake调用中增加 -DLLVM_TOOL_CLANG_TOOLS_EXTRA_BUILD=ON, 然后 make clangd即可。
至此，我们成功安装了clang开发所需的基础环境。
