CMake构建时如何确定正确的ZSH $fpath以适配不同Linux发行版差异

安全阿岳

2026-9-26

适配方案

首先通过CMake探测zsh路径并动态获取目标安装目录
你可以在构建脚本中加入以下逻辑，无需依赖当前运行环境的$fpath变量，直接调用zsh二进制查询官方推荐的补全安装路径：

find_program(ZSH_EXECUTABLE zsh)
if(ZSH_EXECUTABLE)
  execute_process(
    COMMAND ${ZSH_EXECUTABLE} -c "print -r -- ${CMAKE_INSTALL_PREFIX}/share/zsh/site-functions \${fpath[(Ie)${CMAKE_INSTALL_PREFIX}/share/zsh/vendor-functions]}"
    OUTPUT_VARIABLE ZSH_COMPLETION_DIR
    OUTPUT_STRIP_TRAILING_WHITESPACE
  )
  # 取返回结果中的第一个有效路径
  string(REGEX REPLACE " .*" "" ZSH_COMPLETION_DIR "${ZSH_COMPLETION_DIR}")
else()
  # 未找到zsh时使用默认路径作为 fallback
  set(ZSH_COMPLETION_DIR "${CMAKE_INSTALL_PREFIX}/share/zsh/site-functions")
endif()

# 提供可配置选项供打包者自定义路径
set(ZSH_COMPLETION_INSTALL_DIR "${ZSH_COMPLETION_DIR}" CACHE PATH "Path to install zsh completion files")
install(FILES your_completion_script DESTINATION "${ZSH_COMPLETION_INSTALL_DIR}")

上述逻辑会自动适配不同发行版的路径规则：CMAKE_INSTALL_PREFIX为/usr时，Ubuntu会返回vendor-functions路径，Fedora会返回site-functions路径；前缀为/usr/local时则统一用site-functions。

针对打包场景做适配说明
你可以在项目的打包文档中明确标注，各发行版维护者可以通过-DZSH_COMPLETION_INSTALL_DIR=参数手动指定符合对应发行版规范的补全安装路径，无需修改项目构建逻辑。
兜底提示
如果安装后补全未生效，可以提示用户手动将安装路径添加到zsh的fpath中，在~/.zshrc中加入fpath+=/path/to/your/completion/dir后重新加载配置即可。