C++ gRPC项目编译报错fatal error: 'grpcpp/grpcpp.h' file not found如何解决

你遇到的是C++编译阶段头文件搜索失败的问题，核心有两个错误点：

• 环境变量配置错误：$PATH是系统查找可执行程序的路径，和C/C++编译时的头文件搜索逻辑完全无关，你把/opt/homebrew/include加到$PATH没有任何作用。
• 编译命令参数缺失：你当前使用的pkg-config只加了--libs参数，这个参数仅返回链接阶段需要的库配置，不会返回编译阶段需要的头文件搜索路径参数，所以g++找不到对应的头文件。

临时编译修复 #

直接修改编译命令，给pkg-config同时添加--cflags和--libs参数，就能自动导入头文件搜索路径和链接库配置：

# 编译客户端
g++ -std=c++17 client.cpp mathtest.pb.cc mathtest.grpc.pb.cc -o client `pkg-config --cflags --libs protobuf grpc++`
# 编译服务端
g++ -std=c++17 server.cpp mathtest.pb.cc mathtest.grpc.pb.cc -o server `pkg-config --cflags --libs protobuf grpc++`

永久环境配置（针对Homebrew环境） #

如果不想每次编译都加参数，可以修改shell配置文件（根据你使用的shell选择~/.zshrc或~/.bashrc），添加如下配置：

# 配置C++头文件默认搜索路径
export CPLUS_INCLUDE_PATH=/opt/homebrew/include:$CPLUS_INCLUDE_PATH
# 配置链接库默认搜索路径
export LIBRARY_PATH=/opt/homebrew/lib:$LIBRARY_PATH
# 配置pkg-config默认搜索路径
export PKG_CONFIG_PATH=/opt/homebrew/lib/pkgconfig:$PKG_CONFIG_PATH

修改完成后执行source ~/.zshrc（对应zsh）或source ~/.bashrc（对应bash）生效，后续编译即可自动识别对应路径。

VSCode智能提示正常是因为C/C插件会自动扫描系统常见头文件路径（包括Homebrew的/opt/homebrew/include目录），和终端编译时g的搜索逻辑是独立的，所以会出现提示正常但编译失败的情况。

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