2026/9/18 5:47:08
FEATURED · 精选文章 
F3D 开发工具链实战指南覆盖率报告、Sanitizer 测试与文档站维护【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d本文面向 F3D 的贡献者与二次开发者完整讲解仓库开发文档 doc/dev/07-TOOLING.md 中的五类工具链操作基于 gcovr 的全量覆盖率报告、基于 Clang Sanitizer 的内存/线程/未定义行为检测、项目网站的本地构建与运行、master 分支文档的同步更新以及新版本发布时的文档版本化管理。读完本文你将掌握 F3D 从改代码到验证质量再到发布文档的完整开发闭环并理解每个命令背后的 CMake 配置与测试框架实现。一、生成全量覆盖率报告覆盖率报告用于量化测试对源码的覆盖程度是评估测试质量、发现未覆盖代码分支的直接手段。F3D 的覆盖率流程依赖gcovr工具与gcc工具链核心思路是先以带覆盖率插桩的方式编译再运行全部测试产出.gcda数据文件最后用 gcovr 汇总成 HTML 报告。1.1 前置条件gcovr覆盖率汇总工具同时支持--html --html-details输出带逐行标注的 HTML 报告gcc工具链--coverage插桩与数据收集依赖 GCC 生态xdotoolLinux 下模拟 X11 键盘/鼠标事件的工具用于驱动交互类测试例如 application/testing/tests.interaction.cmake 中的键盘/鼠标交互场景。未安装时相关测试无法运行也就无法产生对应的.gcda文件。1.2 构建开启 F3D_COVERAGE在 CMakeLists.txt 中覆盖率由F3D_COVERAGE选项控制# Coverage cmake_dependent_option(F3D_COVERAGE Emit coverage files OFF UNIX OFF) mark_as_advanced(F3D_COVERAGE) set(f3d_coverage_compile_options ) set(f3d_coverage_link_options ) if(F3D_COVERAGE) set(f3d_coverage_compile_options -g -O0 --coverage -fprofile-updateatomic) set(f3d_coverage_link_options --coverage) endif()从源码可以看出三点关键信息该选项是cmake_dependent_option仅在 UNIX 平台生效Windows/macOS 之外的其他平台下固定为 OFF开启后会同时追加编译选项-g -O0 --coverage -fprofile-updateatomic与链接选项--coverage-g保留调试符号便于 gcovr 关联源码行-O0关闭优化避免行号错位--coverage同时启用编译插桩与链接期支持-fprofile-updateatomic保证多线程环境下计数器更新是原子操作这些选项通过f3d_compile_options_public/f3d_link_options_public传递到整个项目的所有目标。因此构建命令形如cmake -S . -B build -DF3D_COVERAGEON -DBUILD_TESTINGON cmake --build build1.3 运行全部测试构建完成后运行全部测试确保已安装xdotool。F3D 的测试体系通过 cmake/f3dTest.cmake 统一注册包括渲染测试、交互测试、SDK 测试等测试定义分散于 application/testing、library/testing、python/testing、java/testing、c/testing 等目录。测试运行完毕后插桩程序会在各目标输出目录留下大量.gcda文件它们是覆盖率报告的原始数据。1.4 生成报告使用 gcovr 汇总并输出 HTMLgcovr -r /path/to/sources --html --html-details -o coverage.html参数说明-r /path/to/sources指定源码根目录gcovr 据此将行号映射回源码文件--html输出 HTML 格式--html-details为每个源码文件生成独立的详细页面含逐行命中标注同时生成总览索引页-o coverage.html指定输出文件。生成的coverage.html会给出整体覆盖率百分比并可下钻到每个文件、每一行代码的命中情况帮助定位测试盲区。仓库根目录的 codecov.yml 还配置了与 CI 集成的覆盖率阈值与状态检查可作为本地报告之外的另一道质量闸门。二、使用 Sanitizer 构建与测试Sanitizer 是 Clang/GCC 提供的运行时动态检测工具族可在程序执行时捕获内存错误、数据竞争、未定义行为等问题。F3D 通过F3D_SANITIZER一个选项即可切换多种检测器且测试框架会为不同检测器自动调整超时确保检测器带来的性能开销不会导致测试误报超时。2.1 可选值与编译选项细节在 CMakeLists.txt 中F3D_SANITIZER定义如下# Sanitizer if(NOT F3D_SANITIZER) set(F3D_SANITIZER none CACHE STRING Sanitizer type FORCE) set_property(CACHE F3D_SANITIZER PROPERTY STRINGS none address thread leak memory undefined) endif() mark_as_advanced(F3D_SANITIZER) if(NOT UNIX) set_property(CACHE F3D_SANITIZER PROPERTY TYPE INTERNAL) endif() set(f3d_sanitizer_compile_options ) set(f3d_sanitizer_link_options ) if(NOT F3D_SANITIZER STREQUAL none) set(f3d_sanitizer_compile_options -fsanitize${F3D_SANITIZER} -fno-optimize-sibling-calls -fno-omit-frame-pointer -g) if(${F3D_SANITIZER} STREQUAL address) list(APPEND f3d_sanitizer_compile_options -fsanitize-address-use-after-scope) endif() if(${F3D_SANITIZER} STREQUAL memory) list(APPEND f3d_sanitizer_compile_options -fsanitize-memory-track-origins) endif() set(f3d_sanitizer_link_options -fsanitize${F3D_SANITIZER}) endif()可用的F3D_SANITIZER取值及其用途取值检测器主要检测目标none无默认值关闭 sanitizeraddressAddressSanitizer堆/栈越界、释放后使用use-after-free、内存泄漏threadThreadSanitizer数据竞争、死锁等线程问题leakLeakSanitizer仅检测内存泄漏memoryMemorySanitizer未初始化内存读取undefinedUndefinedBehaviorSanitizer未定义行为如整数溢出、非法移位、空指针解引用编译期行为细节统一追加-fsanitizetype -fno-optimize-sibling-calls -fno-omit-frame-pointer -g前一个开启对应检测器的插桩-fno-optimize-sibling-calls关闭尾调用优化保证栈回溯stack trace完整-fno-omit-frame-pointer保留帧指针让错误报告能精确定位调用链-g保留调试信息address额外追加-fsanitize-address-use-after-scope将检测扩展到离开作用域后仍使用栈变量的场景memory额外追加-fsanitize-memory-track-origins当读取到未初始化内存时能追踪其来源链接期同样追加-fsanitizetype确保运行时库正确链接平台限制非 UNIX 平台下该选项被强制设为内部变量TYPE INTERNAL即 sanitizer 构建仅面向 Linux/Unix 等环境。构建命令示例以 AddressSanitizer 为例cmake -S . -B build-asan -DF3D_SANITIZERaddress -DBUILD_TESTINGON cmake --build build-asan2.2 配置抑制文件与环境变量Sanitizer 对第三方库如 GPU 驱动、Qt、OCCT、TBB经常产生误报。F3D 在仓库根目录提供了两份抑制文件文档要求运行测试前先导出环境变量export LSAN_OPTIONSsuppressions/path/to/f3d/.lsan.supp:use_tls0 export TSAN_OPTIONSsuppressions/path/to/f3d/.tsan.suppLSAN_OPTIONSLeakSanitizer常随 ASan 启用的配置suppressions指向 .lsan.suppuse_tls0关闭线程局部存储相关检查路径以规避已知误报。打开 .lsan.supp 可以看到其中按来源屏蔽了 NVIDIA 驱动nvidia-glcore、内核加载器ld-linux-x86-64、OCCT 各模块TKBO、TKMath、TKernel等、TBBlibtbb、Mesa 软渲染libOSMesa、libGLX_mesa、libEGL_mesa、Qt6libQt6Core、VTK 的 png 模块libvtkpng与 GDALlibgdal——这些都是非 F3D 代码的已知泄漏源TSAN_OPTIONSThreadSanitizer 的配置suppressions指向 .tsan.supp。该文件屏蔽了 Qt6libQt6Core、libQt6XcbQpa、Mesa swrast 软渲染swrast_dri、VTK 数据模型与 TBB 组合libvtkCommonDataModel、OpenEXRlibOpenEXR、PDALlibpdalcpp以及 Mesa 其他组件libOSMesa、libgallium中的数据竞争误报。导出环境变量后运行全部测试即可sanitizer 检测到问题时会在终端输出带调用栈的详细报告。2.3 测试框架对 sanitizer 的适配F3D 的测试框架针对不同检测器的性能开销做了专门处理体现在 cmake/f3dTest.cmake# sanitizer multipliers (multipliers are coming from ASan documentation) # undefined and leak have no overhead if(F3D_SANITIZER STREQUAL address) math(EXPR _timeout 2 * ${_timeout}) endif() if(F3D_SANITIZER STREQUAL thread) math(EXPR _timeout 15 * ${_timeout}) endif() if(F3D_SANITIZER STREQUAL memory) math(EXPR _timeout 3 * ${_timeout}) endif()即测试默认超时 30 秒长超时测试 120 秒而 AddressSanitizer 下自动翻倍为 2 倍、MemorySanitizer 下 3 倍、ThreadSanitizer 下高达 15 倍undefined与leak因几乎没有额外开销而不调整。这解释了为什么文档要求直接运行全部测试即可——超时已由构建系统按检测器自动放大。此外部分测试在特定 sanitizer 下会被跳过或调整行为例如application/testing/tests.backends.cmake 仅在F3D_SANITIZER STREQUAL none时启用部分后端测试vtkext/public/module/Testing/CMakeLists.txt 与 plugins/assimp/module/Testing/CMakeLists.txt 会在 AddressSanitizer 下禁用部分渲染相关用例。这些条件编译保证了 sanitizer 构建下测试套件依然可完整、稳定地跑通。三、本地生成并运行项目网站F3D 的官方文档站基于 Docusaurus独立维护在 f3d-website 仓库中与主仓库解耦。贡献者需要本地起一个网站实例来预览文档改动。操作步骤安装npmNode.js 包管理器克隆f3d-website仓库与主仓库相互独立需单独获取安装依赖npm install构建并启动本地开发服务器npm run start。启动后即可在本地浏览器访问站点、实时预览文档页面。需要特别说明的是本地环境的搜索栏不可用这是预期行为。搜索功能依赖线上部署时的索引构建本地开发服务器不会生成该索引因此无需排查。补充说明主仓库根目录的 package.json 是 WebAssembly 构建/发布所用的 npm 包脚本指向webassembly/build.sh与 docker 容器与文档网站无关两者不要混淆。四、为最新 master 生成文档当主仓库master分支的文档doc/user、doc/libf3d、doc/dev 等发生变更后需要把最新内容同步到网站按上一节步骤完成网站仓库的克隆、npm install与npm run start在网站仓库目录执行文档更新命令npm run update-doc——该脚本会从主仓库拉取最新文档并写入网站对应目录刷新浏览器页面即可看到更新后的文档。这套流程保证网站文档始终与 master 分支保持同步适合日常开发迭代。五、为新版本发布更新文档正式发布新版本时文档需要按版本固化versioned docs以便用户能够查看特定版本的文档。流程如下先按本地生成并运行网站一节完成环境准备更新 release 分支对应的文档npm run update-doc release——与 master 不同这里以 release 分支的文档内容为准创建新版本化文档npm run docusaurus docs:version X.Y其中X.Y替换为实际版本号如3.5Docusaurus 会将该版本文档快照到版本化目录在网站配置的docusaurus.config.ts中将X.Y加入docsVersionDropdown数组使该版本出现在页面的版本下拉列表中重新构建网站npm run start刷新页面即可看到新的版本化文档入口。通过这套release 分支文档 docs:version快照 下拉框配置的组合F3D 在发布新版本时既能保留历史版本文档又能让用户在各版本间自由切换查阅。六、小结覆盖率-DF3D_COVERAGEON构建 → 装好xdotool跑全部测试 →gcovr -r src --html --html-details -o coverage.html生成逐行标注的 HTML 报告Sanitizer-DF3D_SANITIZERaddress|thread|memory|undefined|leak构建导出LSAN_OPTIONS/TSAN_OPTIONS指向仓库根目录的 .lsan.supp 与 .tsan.supp测试超时会由 cmake/f3dTest.cmake 按检测器自动放大文档站独立仓库 npm install npm run start本地预览搜索栏不可用属预期master 更新用npm run update-doc版本发布用npm run update-doc releasedocusaurus docs:version X.Y 在docusaurus.config.ts的docsVersionDropdown注册新版本。以上五类操作覆盖了 F3D 从质量验证覆盖率、Sanitizer到用户文档交付网站预览、版本化发布的完整工具链是参与 F3D 开发与发布流程的必备技能。更多构建与测试背景可参阅 doc/dev/05-BUILD.md 与 doc/dev/06-TESTING.md。【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
F3D 开发工具链实战指南：覆盖率报告、Sanitizer 测试与文档站维护
F3D 开发工具链实战指南覆盖率报告、Sanitizer 测试与文档站维护【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d本文面向 F3D 的贡献者与二次开发者完整讲解仓库开发文档 doc/dev/07-TOOLING.md 中的五类工具链操作基于 gcovr 的全量覆盖率报告、基于 Clang Sanitizer 的内存/线程/未定义行为检测、项目网站的本地构建与运行、master 分支文档的同步更新以及新版本发布时的文档版本化管理。读完本文你将掌握 F3D 从改代码到验证质量再到发布文档的完整开发闭环并理解每个命令背后的 CMake 配置与测试框架实现。一、生成全量覆盖率报告覆盖率报告用于量化测试对源码的覆盖程度是评估测试质量、发现未覆盖代码分支的直接手段。F3D 的覆盖率流程依赖gcovr工具与gcc工具链核心思路是先以带覆盖率插桩的方式编译再运行全部测试产出.gcda数据文件最后用 gcovr 汇总成 HTML 报告。1.1 前置条件gcovr覆盖率汇总工具同时支持--html --html-details输出带逐行标注的 HTML 报告gcc工具链--coverage插桩与数据收集依赖 GCC 生态xdotoolLinux 下模拟 X11 键盘/鼠标事件的工具用于驱动交互类测试例如 application/testing/tests.interaction.cmake 中的键盘/鼠标交互场景。未安装时相关测试无法运行也就无法产生对应的.gcda文件。1.2 构建开启 F3D_COVERAGE在 CMakeLists.txt 中覆盖率由F3D_COVERAGE选项控制# Coverage cmake_dependent_option(F3D_COVERAGE Emit coverage files OFF UNIX OFF) mark_as_advanced(F3D_COVERAGE) set(f3d_coverage_compile_options ) set(f3d_coverage_link_options ) if(F3D_COVERAGE) set(f3d_coverage_compile_options -g -O0 --coverage -fprofile-updateatomic) set(f3d_coverage_link_options --coverage) endif()从源码可以看出三点关键信息该选项是cmake_dependent_option仅在 UNIX 平台生效Windows/macOS 之外的其他平台下固定为 OFF开启后会同时追加编译选项-g -O0 --coverage -fprofile-updateatomic与链接选项--coverage-g保留调试符号便于 gcovr 关联源码行-O0关闭优化避免行号错位--coverage同时启用编译插桩与链接期支持-fprofile-updateatomic保证多线程环境下计数器更新是原子操作这些选项通过f3d_compile_options_public/f3d_link_options_public传递到整个项目的所有目标。因此构建命令形如cmake -S . -B build -DF3D_COVERAGEON -DBUILD_TESTINGON cmake --build build1.3 运行全部测试构建完成后运行全部测试确保已安装xdotool。F3D 的测试体系通过 cmake/f3dTest.cmake 统一注册包括渲染测试、交互测试、SDK 测试等测试定义分散于 application/testing、library/testing、python/testing、java/testing、c/testing 等目录。测试运行完毕后插桩程序会在各目标输出目录留下大量.gcda文件它们是覆盖率报告的原始数据。1.4 生成报告使用 gcovr 汇总并输出 HTMLgcovr -r /path/to/sources --html --html-details -o coverage.html参数说明-r /path/to/sources指定源码根目录gcovr 据此将行号映射回源码文件--html输出 HTML 格式--html-details为每个源码文件生成独立的详细页面含逐行命中标注同时生成总览索引页-o coverage.html指定输出文件。生成的coverage.html会给出整体覆盖率百分比并可下钻到每个文件、每一行代码的命中情况帮助定位测试盲区。仓库根目录的 codecov.yml 还配置了与 CI 集成的覆盖率阈值与状态检查可作为本地报告之外的另一道质量闸门。二、使用 Sanitizer 构建与测试Sanitizer 是 Clang/GCC 提供的运行时动态检测工具族可在程序执行时捕获内存错误、数据竞争、未定义行为等问题。F3D 通过F3D_SANITIZER一个选项即可切换多种检测器且测试框架会为不同检测器自动调整超时确保检测器带来的性能开销不会导致测试误报超时。2.1 可选值与编译选项细节在 CMakeLists.txt 中F3D_SANITIZER定义如下# Sanitizer if(NOT F3D_SANITIZER) set(F3D_SANITIZER none CACHE STRING Sanitizer type FORCE) set_property(CACHE F3D_SANITIZER PROPERTY STRINGS none address thread leak memory undefined) endif() mark_as_advanced(F3D_SANITIZER) if(NOT UNIX) set_property(CACHE F3D_SANITIZER PROPERTY TYPE INTERNAL) endif() set(f3d_sanitizer_compile_options ) set(f3d_sanitizer_link_options ) if(NOT F3D_SANITIZER STREQUAL none) set(f3d_sanitizer_compile_options -fsanitize${F3D_SANITIZER} -fno-optimize-sibling-calls -fno-omit-frame-pointer -g) if(${F3D_SANITIZER} STREQUAL address) list(APPEND f3d_sanitizer_compile_options -fsanitize-address-use-after-scope) endif() if(${F3D_SANITIZER} STREQUAL memory) list(APPEND f3d_sanitizer_compile_options -fsanitize-memory-track-origins) endif() set(f3d_sanitizer_link_options -fsanitize${F3D_SANITIZER}) endif()可用的F3D_SANITIZER取值及其用途取值检测器主要检测目标none无默认值关闭 sanitizeraddressAddressSanitizer堆/栈越界、释放后使用use-after-free、内存泄漏threadThreadSanitizer数据竞争、死锁等线程问题leakLeakSanitizer仅检测内存泄漏memoryMemorySanitizer未初始化内存读取undefinedUndefinedBehaviorSanitizer未定义行为如整数溢出、非法移位、空指针解引用编译期行为细节统一追加-fsanitizetype -fno-optimize-sibling-calls -fno-omit-frame-pointer -g前一个开启对应检测器的插桩-fno-optimize-sibling-calls关闭尾调用优化保证栈回溯stack trace完整-fno-omit-frame-pointer保留帧指针让错误报告能精确定位调用链-g保留调试信息address额外追加-fsanitize-address-use-after-scope将检测扩展到离开作用域后仍使用栈变量的场景memory额外追加-fsanitize-memory-track-origins当读取到未初始化内存时能追踪其来源链接期同样追加-fsanitizetype确保运行时库正确链接平台限制非 UNIX 平台下该选项被强制设为内部变量TYPE INTERNAL即 sanitizer 构建仅面向 Linux/Unix 等环境。构建命令示例以 AddressSanitizer 为例cmake -S . -B build-asan -DF3D_SANITIZERaddress -DBUILD_TESTINGON cmake --build build-asan2.2 配置抑制文件与环境变量Sanitizer 对第三方库如 GPU 驱动、Qt、OCCT、TBB经常产生误报。F3D 在仓库根目录提供了两份抑制文件文档要求运行测试前先导出环境变量export LSAN_OPTIONSsuppressions/path/to/f3d/.lsan.supp:use_tls0 export TSAN_OPTIONSsuppressions/path/to/f3d/.tsan.suppLSAN_OPTIONSLeakSanitizer常随 ASan 启用的配置suppressions指向 .lsan.suppuse_tls0关闭线程局部存储相关检查路径以规避已知误报。打开 .lsan.supp 可以看到其中按来源屏蔽了 NVIDIA 驱动nvidia-glcore、内核加载器ld-linux-x86-64、OCCT 各模块TKBO、TKMath、TKernel等、TBBlibtbb、Mesa 软渲染libOSMesa、libGLX_mesa、libEGL_mesa、Qt6libQt6Core、VTK 的 png 模块libvtkpng与 GDALlibgdal——这些都是非 F3D 代码的已知泄漏源TSAN_OPTIONSThreadSanitizer 的配置suppressions指向 .tsan.supp。该文件屏蔽了 Qt6libQt6Core、libQt6XcbQpa、Mesa swrast 软渲染swrast_dri、VTK 数据模型与 TBB 组合libvtkCommonDataModel、OpenEXRlibOpenEXR、PDALlibpdalcpp以及 Mesa 其他组件libOSMesa、libgallium中的数据竞争误报。导出环境变量后运行全部测试即可sanitizer 检测到问题时会在终端输出带调用栈的详细报告。2.3 测试框架对 sanitizer 的适配F3D 的测试框架针对不同检测器的性能开销做了专门处理体现在 cmake/f3dTest.cmake# sanitizer multipliers (multipliers are coming from ASan documentation) # undefined and leak have no overhead if(F3D_SANITIZER STREQUAL address) math(EXPR _timeout 2 * ${_timeout}) endif() if(F3D_SANITIZER STREQUAL thread) math(EXPR _timeout 15 * ${_timeout}) endif() if(F3D_SANITIZER STREQUAL memory) math(EXPR _timeout 3 * ${_timeout}) endif()即测试默认超时 30 秒长超时测试 120 秒而 AddressSanitizer 下自动翻倍为 2 倍、MemorySanitizer 下 3 倍、ThreadSanitizer 下高达 15 倍undefined与leak因几乎没有额外开销而不调整。这解释了为什么文档要求直接运行全部测试即可——超时已由构建系统按检测器自动放大。此外部分测试在特定 sanitizer 下会被跳过或调整行为例如application/testing/tests.backends.cmake 仅在F3D_SANITIZER STREQUAL none时启用部分后端测试vtkext/public/module/Testing/CMakeLists.txt 与 plugins/assimp/module/Testing/CMakeLists.txt 会在 AddressSanitizer 下禁用部分渲染相关用例。这些条件编译保证了 sanitizer 构建下测试套件依然可完整、稳定地跑通。三、本地生成并运行项目网站F3D 的官方文档站基于 Docusaurus独立维护在 f3d-website 仓库中与主仓库解耦。贡献者需要本地起一个网站实例来预览文档改动。操作步骤安装npmNode.js 包管理器克隆f3d-website仓库与主仓库相互独立需单独获取安装依赖npm install构建并启动本地开发服务器npm run start。启动后即可在本地浏览器访问站点、实时预览文档页面。需要特别说明的是本地环境的搜索栏不可用这是预期行为。搜索功能依赖线上部署时的索引构建本地开发服务器不会生成该索引因此无需排查。补充说明主仓库根目录的 package.json 是 WebAssembly 构建/发布所用的 npm 包脚本指向webassembly/build.sh与 docker 容器与文档网站无关两者不要混淆。四、为最新 master 生成文档当主仓库master分支的文档doc/user、doc/libf3d、doc/dev 等发生变更后需要把最新内容同步到网站按上一节步骤完成网站仓库的克隆、npm install与npm run start在网站仓库目录执行文档更新命令npm run update-doc——该脚本会从主仓库拉取最新文档并写入网站对应目录刷新浏览器页面即可看到更新后的文档。这套流程保证网站文档始终与 master 分支保持同步适合日常开发迭代。五、为新版本发布更新文档正式发布新版本时文档需要按版本固化versioned docs以便用户能够查看特定版本的文档。流程如下先按本地生成并运行网站一节完成环境准备更新 release 分支对应的文档npm run update-doc release——与 master 不同这里以 release 分支的文档内容为准创建新版本化文档npm run docusaurus docs:version X.Y其中X.Y替换为实际版本号如3.5Docusaurus 会将该版本文档快照到版本化目录在网站配置的docusaurus.config.ts中将X.Y加入docsVersionDropdown数组使该版本出现在页面的版本下拉列表中重新构建网站npm run start刷新页面即可看到新的版本化文档入口。通过这套release 分支文档 docs:version快照 下拉框配置的组合F3D 在发布新版本时既能保留历史版本文档又能让用户在各版本间自由切换查阅。六、小结覆盖率-DF3D_COVERAGEON构建 → 装好xdotool跑全部测试 →gcovr -r src --html --html-details -o coverage.html生成逐行标注的 HTML 报告Sanitizer-DF3D_SANITIZERaddress|thread|memory|undefined|leak构建导出LSAN_OPTIONS/TSAN_OPTIONS指向仓库根目录的 .lsan.supp 与 .tsan.supp测试超时会由 cmake/f3dTest.cmake 按检测器自动放大文档站独立仓库 npm install npm run start本地预览搜索栏不可用属预期master 更新用npm run update-doc版本发布用npm run update-doc releasedocusaurus docs:version X.Y 在docusaurus.config.ts的docsVersionDropdown注册新版本。以上五类操作覆盖了 F3D 从质量验证覆盖率、Sanitizer到用户文档交付网站预览、版本化发布的完整工具链是参与 F3D 开发与发布流程的必备技能。更多构建与测试背景可参阅 doc/dev/05-BUILD.md 与 doc/dev/06-TESTING.md。【免费下载链接】f3dFast and minimalist 3D viewer.项目地址: https://gitcode.com/GitHub_Trending/f3/f3d创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
