CodeQL

GitHub, Inc. · 使用 GitHub 的 CodeQL 命令列工具建立程式碼分析資料庫、執行語義安全查詢並匯出發現結果。

Cask開發工具Apple 晶片 · Intel
主頁
來自 homebrew/cask
近 30 天安裝
594
App榜第 318
近一年安裝
5706
365 天累計
最新版本
2.27.3
5 天前 · 10月20日
下載大小
984MB
arm64 / x86_64 · zip
更新節奏
每兩週
近 30 天 3 個版本

CodeQL 是一款開發工具類 Mac 軟體。開發者是 GitHub, Inc.。

基本資訊

晶片
Apple 晶片 · Intel
價格
免費,含應用內購買 · 價格詳情
開發者
GitHub, Inc.
安裝命令
brew install --cask codeql
Homebrew
可以安裝,由 Homebrew 更新
其他名稱
codeql

以上資訊最早核查於 。檢視各項來源

介紹

AI 翻譯檢視原文

CodeQL 是 GitHub 的語義程式碼分析系統。此軟體包會安裝 CodeQL 命令列介面,用於從程式碼建立分析資料庫、解析並執行查詢,以及生成結果,供審查或程式碼掃描工作流使用。它面向安全研究人員、開發者,以及將靜態分析整合到開發或 CI 流程中的團隊。

分析工作流

為受支援的語言構建 CodeQL 資料庫,選擇相容的查詢包或查詢套件,然後分析生成的資料庫。查詢可以描述程式碼中的資料流和關係,而不僅僅是匹配源文字。結果可匯出為 SARIF 等格式,供相容的檢視器或 GitHub 程式碼掃描使用。VS Code 的獨立 CodeQL 擴充套件提供互動式查詢開發介面;它不是此 cask 安裝的圖形應用程式。

覆蓋範圍取決於語言、提取配置、構建模式和查詢選擇。命令成功執行並不能證明所有原始檔都已提取,或所有漏洞都已檢測到。請檢查警告和資料庫覆蓋情況,並調查發現的問題,再將其視為已確認缺陷。

安裝和先決條件

使用官方的 codeql-osx64.zip 壓縮包或 brew install --cask codeql。Homebrew cask 會從解壓後的發行版中提供 codeql 可執行檔案。儘管檔名包含 osx64,官方發行說明明確將 Apple Silicon 納入 macOS 支援範圍。經核查的來源未給出精確的最低 macOS 版本,也未獨立驗證壓縮包所含二進位制檔案的完整架構,因此不臆造額外的數字要求或 Universal 宣告。

CLI 內含 Java 執行時;版本 2.27.1 將捆綁的 Eclipse Temurin OpenJDK 更新至 25.0.4.1。如有需要,可使用 CODEQL_JAVA_HOME 選擇其他 JDK。語言編譯器、構建工具、專案依賴項,以及相容的 CodeQL 語言或查詢包,均是獨立的工作流先決條件,具體取決於分析內容。cask 本身未宣告單獨的 formula 依賴項或明確的衝突項。僅含 CLI 的平臺 ZIP 不應與包含相容查詢資源的 CodeQL 捆綁包混淆。

常規分析需要訪問原始檔、構建輸出和分析資料庫。經核查的文件未規定一概需要“輔助功能”或“完全磁碟訪問”許可權。為編譯型語言建立資料庫時,可能會執行專案的構建過程;請僅使用可信的原始碼和構建指令碼,併為程式碼庫預留足夠的 CPU、記憶體和磁碟空間。

許可、賬戶和網路

CodeQL CLI 受 GitHub CodeQL 條款和條件約束,這與採用 MIT 許可證的查詢原始碼倉庫不同。下載二進位制檔案並不意味著可以不受限制地將其用於所有私有程式碼庫的商業用途。GitHub 說明,公開倉庫以及具備相應 GitHub Code Security 許可的符合條件的私有倉庫可以使用。請針對預期的程式碼庫和部署方式查閱當前條款。

本地資料庫分析和查詢執行與經過身份驗證的 GitHub 整合彼此獨立。下載軟體包、訪問私有登錄檔以及上傳 SARIF 結果可能需要網路連線和憑據。不要聲稱每種工作流都需要賬戶,也不要聲稱每種工作流都完全離線。啟用上傳前,請妥善保護令牌並檢查組織許可權。

資料和實際風險

分析資料庫和匯出的發現可能包含原始碼衍生資訊、路徑以及安全敏感細節。請根據程式碼庫的保密要求儲存這些資料,並在上傳前檢查目標位置。查詢、軟體包依賴項和構建指令碼可能影響實際執行的內容;請核實其來源。靜態分析可補充測試和審查,但不能保證程式碼庫安全。

官方 v2.27.2 發行頁面列出的 codeql-osx64.zip 大小為 981,956,830 位元組。這是 Mac CLI 壓縮包,不是通用多平臺 ZIP,也不是已安裝資料庫的大小。版本 2.27.0 棄用通用合併發行包,改為提供各平臺專用下載。

CodeQL 2.27.3 說明了構建追蹤限制:編譯型語言的 autobuild 和 manual 構建模式不支援 macOS 27 搭配任意 Xcode,也不支援 macOS 26 選擇 Xcode 27。此限制針對追蹤分析,不能據此斷言其他分析模式全部不受支援。

CodeQL 2.27.3

來源:官方產品、CLI 概念和許可、官方二进制发行版、CLI 條款。

CodeQL 的價格與購買方式

OpenNavo 按地區、版本和計費週期記錄核查過的價格,並註明來源和日期;不記錄歷史價格,也不判斷是否最低。

版本價格地區購買渠道核查日期
—免費,含應用內購買 —官網docs.github.com/en/code-security/codeql-cli/getting-started-with-the-codeql-cli/about-the-codeql-cli

系統要求

macOS應用版本晶片下載來源
適用於 macOS 27, 26, 15, 14, 13, 12, 11 的版本2.27.3Intelgithub.com/github/codeql-cli-binaries/releases/download/v2.27.3/codeql-osx64.zipSHA-256 67732b562bfda6ae2617cf143a496b0f72f4bed0532df966db933917a10b01e8Homebrew核查於
適用於 macOS 27, 26, 15, 14, 13, 12, 11 的版本2.27.3Apple 晶片github.com/github/codeql-cli-binaries/releases/download/v2.27.3/codeql-osx64.zipSHA-256 67732b562bfda6ae2617cf143a496b0f72f4bed0532df966db933917a10b01e8Homebrew核查於

如何在 Mac 上安裝 CodeQL

  1. 在“終端”中執行: brew install --cask codeql

不用 Homebrew 安裝

直接下載 Homebrew 使用的同一個檔案: github.com/github/codeql-cli-binaries/releases/download/v2.27.3/codeql-osx64.zip

SHA-256 只用來核對下載的檔案是否完整,不代表安全認證。 檢視 SHA-256 和下載地址

解除安裝 CodeQL 與可選的資料清理

解除安裝命令
brew uninstall --cask codeql

普通解除安裝會刪除應用本身,設定和快取會保留。

深度清理(可選)

解除安裝命令
brew uninstall --zap --cask codeql

--zap 還會刪除 Homebrew 定義裡列出的設定、快取等檔案,其中可能有其他應用共用的資料,刪除後無法恢復;它也不保證沒有任何殘留。請先備份需要保留的資料;如要保留設定和快取,請不要加 --zap。

CodeQL 可能留在 Mac 上的檔案(1)
檔案和資料夾
~/.codeql

以上條目來自 Homebrew 定義,核查於 ;它們只說明定義宣告會刪除什麼,不代表你的 Mac 上都有。

2.27.3 更新內容

新版本 OpenNavo 編輯 · AI 翻譯

說明 macOS 跟蹤構建限制,新增 JSON 資料擴充套件並修復資料庫降級問題。

CodeQL 的安全事實

這裡只列可以核驗的事實,並註明來源和日期,不是安全認證。要檢查你下載的檔案,可以用 OpenNavo 在本機掃描。

分發渠道
Homebrew
用 OpenNavo 掃描會在 OpenNavo 客戶端中開啟掃描預覽,由你決定是否開始。 瞭解安全防護

安裝細節

來源倉庫
homebrew/cask
附帶命令
codeql
下載地址
https://github.com/github/codeql-cli-binaries/releases/download/v2.27.3/codeql-osx64.zip
SHA-256
67732b562bfda6ae2617cf143a496b0f72f4bed0532df966db933917a10b01e8
Homebrew 定義檔案
github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/codeql.rb
formulae.brew.sh
formulae.brew.sh/cask/codeql
原始碼
github.com/github/codeql-cli-binaries

安裝與解除安裝內容

  • 安裝 binary

    來原始檔: $HOMEBREW_PREFIX/Caskroom/codeql/2.27.3/codeql/codeql

    宣告的目標位置: $HOMEBREW_PREFIX/bin/codeql

    檢視完整宣告
    {
      "binary": [
        "$HOMEBREW_PREFIX/Caskroom/codeql/2.27.3/codeql/codeql"
      ],
      "target": "$HOMEBREW_PREFIX/bin/codeql"
    }
  • 清理使用者資料 zap

    檢視完整宣告
    {
      "zap": [
        {
          "trash": "~/.codeql"
        }
      ]
    }

關於 CodeQL 的常見問題

CodeQL 安全嗎?

CodeQL 收錄在 Homebrew 官方軟體庫中,沒有被停用。自 2026 年 9 月起,Homebrew 會停用沒有透過 macOS Gatekeeper 檢查的應用。安裝時,Homebrew 會用 SHA-256 校驗值核對來自 github.com 的安裝包。過去 30 天,它透過 Homebrew 安裝了 594 次。

CodeQL 免費嗎?

CodeQL 可以免費下載,但提供應用內購買。來源:docs.github.com/en/code-security/codeql-cli/getting-started-with-the-codeql-cli/about-the-codeql-cli,核查於 10月22日。

怎樣在 Mac 上徹底解除安裝 CodeQL?

執行 brew uninstall --cask codeql。要連設定和快取一起刪除,執行 brew uninstall --zap --cask codeql。--zap 還會刪除 Homebrew 定義裡列出的設定、快取等檔案,其中可能有其他應用共用的資料,刪除後無法恢復;它也不保證沒有任何殘留。請先備份需要保留的資料;如要保留設定和快取,請不要加 --zap。這會同時刪除 ~/.codeql。

CodeQL 支援 Apple 晶片(M1 及更新)的 Mac 嗎?

Apple 晶片和 Intel 晶片的 Mac 都能用 Homebrew 安裝,兩者使用同一個安裝包。

CodeQL 的設定和資料儲存在哪裡?

資料儲存在 ~/.codeql。這些位置來自 Homebrew 的清理清單。

CodeQL 的最新版本是多少?

最新版本是 2.27.3,Homebrew 收錄於 10月20日。執行 brew upgrade --cask codeql 即可更新。

安裝 CodeQL 還會裝上什麼?

還會裝上 1 個命令列工具:codeql。

來源

頁面上的每項資料都註明來源和核查日期;過期的資料只寫“截至”某日,不再當作當前事實。