CMake构建PicoMite链接失败：空目标文件问题如何修复？

问题分析 #

编译流程正常完成，但链接阶段报错，提示tud_cdc_n_connected、stdio_usb等tinyusb相关符号未定义。排查发现cdc_device.c.obj这类依赖库目标文件仅740字节，且无有效符号表，说明对应源文件未被正确编译，仅处理了头文件。

修复方案（修改CMakeLists.txt） #

针对此类依赖库编译不完整的问题，可从以下几个方向调整CMake配置：

1. 确保tinyusb组件被正确启用 #

在项目根目录的CMakeLists.txt中，通过Pico SDK的组件机制引入tinyusb并开启CDC类支持，这会自动触发相关源文件的编译：

# 启用USB作为标准输入输出，自动配置tinyusb CDC设备
pico_enable_stdio_usb(PicoMiteWeb 1)
# 可根据需求关闭UART标准输入输出
pico_enable_stdio_uart(PicoMiteWeb 0)

# 明确将tinyusb相关库链接到目标程序
target_link_libraries(PicoMiteWeb PRIVATE
    pico_stdlib
    tinyusb_device
    tinyusb_board
    # 项目其他依赖库...
)

2. 检查手动添加的源文件是否完整 #

如果项目中手动引入了tinyusb的源文件，确认CMakeLists.txt中没有遗漏必要的文件：

add_executable(PicoMiteWeb
    PicoMite.c
    # 项目自有源文件...
    ${PICO_TINYUSB_PATH}/src/class/cdc/cdc_device.c
    ${PICO_TINYUSB_PATH}/src/device/usbd.c
    # 其他tinyusb核心源文件...
)

优先推荐使用SDK组件机制（通过target_link_libraries引入tinyusb_device），避免手动添加源文件时出现路径或文件遗漏。

3. 清理缓存后重新构建 #

修改CMake配置后，必须清理旧build目录的缓存文件，避免残留的错误配置影响编译：

cd build
rm -rf *
cmake ..
make -j4

4. 确认编译宏定义正确 #

tinyusb的编译依赖特定宏控制功能开关，若未使用SDK自动配置，需手动添加：

target_compile_definitions(PicoMiteWeb PRIVATE
    CFG_TUD_CDC=1
    # 其他tinyusb相关配置宏...
)

若使用pico_enable_stdio_usb，上述宏会被自动设置，无需手动添加。

修复验证 #

重新构建后，通过以下命令检查目标文件是否正常：

# 查看cdc_device.c.obj的大小
ls -l CMakeFiles/PicoMiteWeb.dir/home/pi/pico/pico-sdk/lib/tinyusb/src/class/cdc/cdc_device.c.obj
# 检查符号表是否包含所需函数
objdump -t CMakeFiles/PicoMiteWeb.dir/home/pi/pico/pico-sdk/lib/tinyusb/src/class/cdc/cdc_device.c.obj

正常情况下，目标文件大小应接近7KB，且符号表中能找到tud_cdc_n_connected等相关函数符号。

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