1

Author: wicyn

.github/workflows/ci.yml

@@ -14,6 +14,7 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+
   # clang-format
   clang-format:
     name: clang-format
@@ -46,6 +47,9 @@ jobs:
         sudo apt-get update -qq
         sudo apt-get install -y -qq clang-tidy-18
     - name: Configure
+      # 需要 compile_commands.json 给 clang-tidy 用；开 TESTS 以便 tidy 能看到测试代码的编译数据库。
+      # 注: 本地无 catch_amalgamated 时, 开 TESTS 会触发 Catch2 下载(走根 TFL_GITHUB_MIRROR)。
+      #     CI runner 可直连 github, 正常; 若偶发因下载失败而红, 即为此处。
       run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug -DTASKFLOWLITE_BUILD_TESTS=ON -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
     - name: Run clang-tidy
       run: |
@@ -61,7 +65,13 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Configure
+      # 只装库: 显式关掉 examples / tests / benchmarks。
+      # - 不编 examples: 此 job 只验证"安装 + 下游 consumer 能 find_package 链接", 编 examples 纯属浪费。
+      # - 不编 tests: 同时避免触发 Catch2 下载(本 job 无需测试, 也不该依赖网络)。
       run: cmake -S . -B build -DCMAKE_INSTALL_PREFIX=${{ github.workspace }}/install
+           -DTASKFLOWLITE_BUILD_EXAMPLES=OFF
+           -DTASKFLOWLITE_BUILD_TESTS=OFF
+           -DTASKFLOWLITE_BUILD_BENCHMARKS=OFF
     - name: Install
       run: cmake --install build
     - name: Verify
@@ -90,4 +100,4 @@ jobs:
         EOF
         cmake -S /tmp/test-consumer -B /tmp/test-consumer/build \
           -DCMAKE_PREFIX_PATH=${{ github.workspace }}/install
-        cmake --build /tmp/test-consumer/build
+        cmake --build /tmp/test-consumer/build

.github/workflows/codeql-analysis.yml

@@ -25,8 +25,13 @@ jobs:
       with:
         languages: cpp
     - name: Build
+      # 只编库本体 + examples 供 CodeQL 扫描自有代码。
+      # 关掉 TESTS: CodeQL 无需测试代码, 且开 TESTS 会触发下载 Catch2(第三方),
+      #             那些源码会被一并扫描、产生与本项目无关的告警, 污染安全分析结果。
       run: |
-        cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DTASKFLOWLITE_BUILD_TESTS=ON
+        cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \
+              -DTASKFLOWLITE_BUILD_EXAMPLES=ON \
+              -DTASKFLOWLITE_BUILD_TESTS=OFF
         cmake --build build --parallel $(nproc)
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v3
+      uses: github/codeql-action/analyze@v3