This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 8754623fc60 [Doc] Add macOS OpenMP build troubleshooting (#3998)
8754623fc60 is described below
commit 8754623fc60cf5a531dd23b2d616f29ecb7274ea
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Sat Jul 18 22:11:28 2026 +0800
[Doc] Add macOS OpenMP build troubleshooting (#3998)
---
community/source-install/compilation-mac.md | 32 ++++++++++++++++++++++
.../current/source-install/compilation-mac.md | 32 ++++++++++++++++++++++
2 files changed, 64 insertions(+)
diff --git a/community/source-install/compilation-mac.md
b/community/source-install/compilation-mac.md
index 1a324bf0c91..5e74a50b115 100644
--- a/community/source-install/compilation-mac.md
+++ b/community/source-install/compilation-mac.md
@@ -178,6 +178,38 @@ Next, configure debugging in your IDE:
## FAQ
+### CMake Cannot Find OpenMP
+
+When compiling BE, CMake may fail to find OpenMP and report the following
errors:
+
+```text
+Could NOT find OpenMP_C (missing: OpenMP_C_FLAGS OpenMP_C_LIB_NAMES)
+fatal error: 'omp.h' file not found
+```
+
+Install `libomp`, then check that its Homebrew installation contains `omp.h`:
+
+```Shell
+brew install libomp
+LIBOMP_PREFIX="$(brew --prefix libomp)"
+test -f "${LIBOMP_PREFIX}/include/omp.h"
+```
+
+Add the following environment variables to `custom_env.sh` in the Doris source
root:
+
+```Shell
+LIBOMP_PREFIX="$(brew --prefix libomp)"
+export CPPFLAGS="-I${LIBOMP_PREFIX}/include ${CPPFLAGS:-}"
+export CFLAGS="-I${LIBOMP_PREFIX}/include ${CFLAGS:-}"
+export CXXFLAGS="-I${LIBOMP_PREFIX}/include ${CXXFLAGS:-}"
+export LDFLAGS="-L${LIBOMP_PREFIX}/lib ${LDFLAGS:-}"
+export EXTRA_CXX_FLAGS="-I${LIBOMP_PREFIX}/include ${EXTRA_CXX_FLAGS:-}"
+```
+
+The `be/CMakeLists.txt` file resets `CMAKE_C_FLAGS` and `CMAKE_CXX_FLAGS`, so
CMake's OpenMP checks may not receive `CPPFLAGS`, `CFLAGS`, or `CXXFLAGS`.
`EXTRA_CXX_FLAGS` passes the `libomp` include path to the BE build and is
required for this workaround.
+
+`custom_env.sh` is a local build configuration file. Do not commit it to the
repository.
+
### Compilation Fails Due to Node.js Version Too High
Error message:
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/source-install/compilation-mac.md
b/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/source-install/compilation-mac.md
index b0be222f79c..d82bceb9631 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/source-install/compilation-mac.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs-community/current/source-install/compilation-mac.md
@@ -178,6 +178,38 @@ cp -r output ../doris-run
## 常见问题
+### CMake 找不到 OpenMP
+
+编译 BE 时，CMake 可能无法找到 OpenMP，并显示以下错误：
+
+```text
+Could NOT find OpenMP_C (missing: OpenMP_C_FLAGS OpenMP_C_LIB_NAMES)
+fatal error: 'omp.h' file not found
+```
+
+先安装 `libomp`，并确认 Homebrew 安装目录中存在 `omp.h`：
+
+```Shell
+brew install libomp
+LIBOMP_PREFIX="$(brew --prefix libomp)"
+test -f "${LIBOMP_PREFIX}/include/omp.h"
+```
+
+然后在 Doris 源码根目录的 `custom_env.sh` 中添加以下环境变量：
+
+```Shell
+LIBOMP_PREFIX="$(brew --prefix libomp)"
+export CPPFLAGS="-I${LIBOMP_PREFIX}/include ${CPPFLAGS:-}"
+export CFLAGS="-I${LIBOMP_PREFIX}/include ${CFLAGS:-}"
+export CXXFLAGS="-I${LIBOMP_PREFIX}/include ${CXXFLAGS:-}"
+export LDFLAGS="-L${LIBOMP_PREFIX}/lib ${LDFLAGS:-}"
+export EXTRA_CXX_FLAGS="-I${LIBOMP_PREFIX}/include ${EXTRA_CXX_FLAGS:-}"
+```
+
+Doris 的 `be/CMakeLists.txt` 会重新设置 `CMAKE_C_FLAGS` 和 `CMAKE_CXX_FLAGS`，因此普通的
`CPPFLAGS`、`CFLAGS` 和 `CXXFLAGS` 可能不会进入 CMake 的 OpenMP 探测命令。上述配置中的关键项是
`EXTRA_CXX_FLAGS`，它会把 `libomp` 的头文件路径传给 BE 构建过程。
+
+`custom_env.sh` 只用于配置本地编译环境，请勿将其提交到代码仓库。
+
### Node.js 版本过高导致编译失败
错误信息：
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
