Mac M1环境下CLion构建C项目链接libnfc时出现未定义符号错误

问题背景 #

在Mac M1（Ventura 13.3.1）环境下，使用CLion构建验证libnfc的项目时，头文件能被正常识别，但链接阶段出现未定义符号错误，提示_nfc_version找不到。

环境信息 #

• 设备版本：Mac Apple M1，Ventura 13.3.1
• Homebrew版本：4.1.11
• CLion版本：232.9921.42（最新版）

编译错误信息 #

FAILED: NFC_Reader 
: && /Library/Developer/CommandLineTools/usr/bin/cc -I/opt/homebrew/include  -g -arch arm64 -isysroot /Library/Developer/CommandLineTools/SDKs/MacOSX13.3.sdk -Wl,-search_paths_first -Wl,-headerpad_max_install_names -L/opt/homebrew/lib CMakeFiles/NFC_Reader.dir/NFC_UID_reader.c.o -o NFC_Reader   && :
Undefined symbols for architecture arm64:
  "_nfc_version", referenced from:
      _main in NFC_UID_reader.c.o
ld: symbol(s) not found for architecture arm64
clang: error: linker command failed with exit code 1 (use -v to see invocation)
ninja: build stopped: subcommand failed.

现有代码文件 #

CMakeLists.txt #

cmake_minimum_required(VERSION 3.26)
project(NFC_Reader C)

set(CMAKE_EXE_LINKER_FLAGS "-L/opt/homebrew/lib " CACHE STRING "" FORCE)
set(CMAKE_C_FLAGS   "-I/opt/homebrew/include " CACHE STRING "" FORCE )
set(CMAKE_CXX_FLAGS "-I/opt/homebrew/include " CACHE STRING "" FORCE)


add_executable(NFC_Reader NFC_UID_reader.c)

主代码NFC_UID_reader.c #

#include <stdlib.h>
#include <nfc/nfc.h>
#include <printf.h>

int main(int argc, const char *argv[]) {
    printf("%s", nfc_version());
}

解决方案 #

问题核心是仅指定了库的搜索路径，但未明确告诉CMake要链接libnfc库。以下是两种可靠的修复方式：

方式1：手动定位并链接库 #

适合libnfc未提供CMake配置文件的场景，手动查找库文件和头文件路径：

cmake_minimum_required(VERSION 3.26)
project(NFC_Reader C)

# 设置C语言标准（可选，推荐添加）
set(CMAKE_C_STANDARD 11)

# 查找libnfc库文件和头文件
find_library(LIBNFC_LIBRARY nfc PATHS /opt/homebrew/lib)
find_path(LIBNFC_INCLUDE_DIR nfc/nfc.h PATHS /opt/homebrew/include)

# 验证是否找到必要文件
if(NOT LIBNFC_LIBRARY)
    message(FATAL_ERROR "未找到libnfc库文件")
endif()
if(NOT LIBNFC_INCLUDE_DIR)
    message(FATAL_ERROR "未找到libnfc头文件")
endif()

# 添加可执行文件
add_executable(NFC_Reader NFC_UID_reader.c)

# 配置头文件路径和链接库
target_include_directories(NFC_Reader PRIVATE ${LIBNFC_INCLUDE_DIR})
target_link_libraries(NFC_Reader PRIVATE ${LIBNFC_LIBRARY})

方式2：使用pkg-config自动配置 #

如果libnfc支持pkg-config（Homebrew安装的版本通常都支持），这种方式更简洁，自动处理所有编译和链接参数：

cmake_minimum_required(VERSION 3.26)
project(NFC_Reader C)

set(CMAKE_C_STANDARD 11)

# 启用pkg-config工具
find_package(PkgConfig REQUIRED)
# 查找并配置libnfc
pkg_check_modules(LIBNFC REQUIRED libnfc)

add_executable(NFC_Reader NFC_UID_reader.c)

# 应用libnfc的配置参数
target_include_directories(NFC_Reader PRIVATE ${LIBNFC_INCLUDE_DIRS})
target_link_libraries(NFC_Reader PRIVATE ${LIBNFC_LIBRARIES})
target_compile_options(NFC_Reader PRIVATE ${LIBNFC_CFLAGS_OTHER})

额外优化建议 #

主代码中的<printf.h>是非标准头文件，标准C的<stdio.h>已包含printf函数，建议替换为：

#include <stdlib.h>
#include <nfc/nfc.h>
#include <stdio.h>

int main(int argc, const char *argv[]) {
    printf("%s\n", nfc_version()); // 添加换行符让输出更规范
}

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