如何为C/C++构建仅静态库、无插件的极简gRPC版本？

我完全懂你这种需求——要一个干净的纯静态gRPC，不带多余的共享库和插件，还得适配自定义SSL、系统zlib，甚至不用安装到系统，直接把二进制存到源码树里给后续项目链接用。我之前在CentOS7上折腾过一模一样的场景，给你一套靠谱的跨平台方案：

1. 准备gRPC源码 #

首先确保你拉取了完整的gRPC源码（包括子模块，因为gRPC依赖protobuf、abseil等核心组件）：

git clone --recurse-submodules https://github.com/grpc/grpc.git
cd grpc
# 可选：切换到稳定版本，比如v1.59.0，避免最新版的兼容性问题
git checkout v1.59.0
git submodule update --init --recursive

2. 核心CMake配置参数（关键！） #

gRPC用CMake构建，你需要通过以下参数精确控制编译行为，这些参数是跨平台通用的，只是路径需要根据系统调整：

mkdir -p build && cd build
cmake ../ \
  -DCMAKE_BUILD_TYPE=Release \
  -DgRPC_BUILD_SHARED_LIBS=OFF \          # 完全禁用共享库，只生成静态库
  -DgRPC_BUILD_PLUGINS=OFF \              # 不构建任何gRPC插件（比如protoc的gRPC代码生成插件）
  -DgRPC_SSL_PROVIDER=package \           # 使用外部SSL库（你的自定义版本），而非gRPC自带的boringssl
  -DOPENSSL_ROOT_DIR=/path/to/your/custom/ssl \  # 替换成你的自定义SSL根目录
  -DZLIB_ROOT=/usr \                      # CentOS7的系统zlib路径，其他系统按需调整（比如macOS可能是/usr/local）
  -DgRPC_INSTALL=ON \                     # 开启install目标，但不会装到系统
  -DCMAKE_INSTALL_PREFIX=/path/to/your/source/tree/grpc-static \  # 替换成你要存放静态库的源码树路径
  -DgRPC_BUILD_TESTS=OFF \                # 禁用测试编译，节省时间和资源
  -Dprotobuf_BUILD_SHARED_LIBS=OFF        # 确保protobuf也生成静态库，和gRPC保持一致

参数踩坑提示： #

• 别把gRPC_INSTALL设为OFF：虽然你不想把gRPC装到系统目录，但开启它并指定自定义的CMAKE_INSTALL_PREFIX，就能让编译产物（静态库、头文件）整齐地放到你指定的源码树目录里，后续项目直接取用即可。
• 必须同步设置protobuf_BUILD_SHARED_LIBS=OFF：gRPC强依赖protobuf，如果protobuf生成共享库，会导致后续链接时出现冲突，所以必须让它也生成静态库。

3. 编译并导出产物 #

执行编译命令（用-j参数利用多核加速）：

make -j$(nproc)
make install

执行完后，你指定的CMAKE_INSTALL_PREFIX目录下会出现两个核心目录：

• lib/：存放所有静态库（比如libgrpc.a、libgrpc++.a、libprotobuf.a等）
• include/：存放所有头文件

4. 后续项目链接注意事项 #

当你在后续项目中链接这个静态gRPC时，需要：

1. 在项目的CMake配置中指定头文件和库路径：

include_directories(/path/to/your/source/tree/grpc-static/include)
link_directories(/path/to/your/source/tree/grpc-static/lib)

2. 链接时要把所有依赖的静态库都列上（静态库不会自动递归依赖）：

target_link_libraries(your_project_name
  grpc
  grpc++
  protobuf
  ssl   # 你的自定义SSL静态库
  crypto
  z     # 系统zlib静态库
)

跨平台适配提示 #

• macOS：调整ZLIB_ROOT为/usr/local，自定义SSL路径根据你的安装位置修改，编译命令用make -j$(sysctl -n hw.ncpu)
• Windows：用Visual Studio的CMake工具链，参数格式换成Windows路径（比如C:\your\custom\ssl），编译用MSBuild INSTALL.vcxproj /p:Configuration=Release

内容的提问来源于stack exchange，提问作者Todd Smith