2.2 KiB
2.2 KiB
Gh API 查詢語法參考
日期查詢語法(CLI)
正確語法
# 查詢特定年份(正確)
gh search issues '彩票导师 --created 2025-01-01..2025-12-31'
# 查詢特定月份(正確)
gh search issues '主管开户 --created 2026-03-01..2026-03-31'
# 查詢某年之后(正確)
gh search issues '彩民 --created 2025-01-01..'
錯誤語法(需避免)
# 錯誤:引號位置錯誤
gh search issues 'created:2025 "彩票导师"'
# 錯誤:ISO 格式不接受 "2025" 作為日期
# 錯誤:created 不支援這種格式
gh search issues 'created:2024..2025 "彩票"'
gh api 查詢 repo/user 資訊
查詢 repo 資訊
# 正確
gh api repos/USER/REPO --jq '{name: .name, created: .created_at, open_issues: .open_issues_count}'
# 注意:USER/REPO 格式,如果 repo 名稱含有 .com 之類的域名也是有效的(如 rthrsd/baidu.com)
查詢 user 資訊
# 正確(users endpoint)
gh api users/USERNAME --jq '{login: .login, created: .created_at}'
# 注意:用 repos/USER 會 404,應改用 users/USER
gh search issues 注意事項
--limit 參數
# 預設 limit 是 30
gh search issues '關鍵字'
gh search issues '關鍵字' --limit 50
--sort 參數
gh search issues '關鍵字' --sort created
gh search issues '關鍵字' --sort updated
--match 參數(限制搜尋範圍)
# 只搜尋標題
gh search issues '關鍵字' --match title
# 只搜尋 body
gh search issues '關鍵字' --match body
網頁版 vs CLI 語法差異
| 功能 | 網頁版 | CLI |
|---|---|---|
| OR 搜尋 | OR 關鍵字 |
CLI 不支援,需分開搜 |
| 日期範圍 | created:2025-01-01..2025-12-31 |
同樣語法 |
| 年份查詢 | created:2025 |
不支援,需用 created:2025-01-01.. |
實用查詢範例
# 查詢 2025 年的 spam
gh search issues '彩票导师 --created 2025-01-01..2025-12-31' --limit 100
# 查詢特定 repo 的所有 issues
gh search issues 'repo:USER/REPO' --limit 100
# 查詢包含多個關鍵字的 issues
gh search issues '主管开户'
gh search issues '彩民'
gh search issues '信誉第一'