GH-SEARCH-CODE(1)              GitHub CLI manual             GH-SEARCH-CODE(1)



نام (NAME)
       gh-search-code - جستجو در میان کدها



خلاصه دستور (SYNOPSIS)
       gh search code <query> [flags]



توضیحات (DESCRIPTION)
       جستجو درون کدهای موجود در مخازن گیت‌هاب.


       سینتکس جستجو در نشانی زیر مستند شده است:

       ⟨https://docs.github.com/search-github/searching-on-github/searching-code⟩


       توجه داشته باشید که این نتایج جستجو توسط موتور جستجوی کدی ارائه می‌شوند
       که اکنون در گیت‌هاب قدیمی (legacy) محسوب می‌شود. ممکن است نتایج با آنچه
       در github.com مشاهده می‌شود مطابقت نداشته باشد، و ویژگی‌های جدیدی مانند
       جستجوی عبارات باقاعده (regex) هنوز از طریق API گیت‌هاب در دسترس نیستند.


       برای کسب اطلاعات بیشتر در مورد مدیریت عبارت‌های جستجوی حاوی خط پیوند،
       دستور gh search --help را اجرا کنید.



گزینه‌ها (OPTIONS)
       --extension <string>
              فیلتر کردن بر اساس پسوند فایل


       --filename <string>
              فیلتر کردن بر اساس نام فایل


       -q, --jq <expression>
              فیلتر کردن خروجی JSON با استفاده از عبارت jq


       --json <fields>
              تولید خروجی JSON با فیلدهای مشخص‌شده


       --language <string>
              فیلتر کردن نتایج بر اساس زبان


       -L, --limit <int> (default 30)
              حداکثر تعداد نتایج کد برای واکشی


       --match <strings>
              محدود کردن جستجو به محتویات فایل یا مسیر فایل: {file|path}


       --owner <strings>
              فیلتر کردن بر اساس مالک


       -R, --repo <OWNER/REPO>
              فیلتر کردن بر اساس مخزن، در قالب OWNER/REPO


       --size <string>
              فیلتر کردن بر اساس محدوده اندازه، به کیلوبایت


       -t, --template <string>
              قالب‌بندی خروجی JSON با استفاده از الگوی Go؛ به "gh help
              formatting" مراجعه کنید


       -w, --web
              باز کردن عبارت جستجو در مرورگر وب



فیلدهای JSON (JSON FIELDS)
       path, repository, sha, textMatches, url



کدهای خروج (EXIT CODES)
       0: اجرای موفقیت‌آمیز


       1: خطا


       2: دستور لغو شد


       4: نیاز به احراز هویت است


       نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای
       اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.



مثال‌ها (EXAMPLES)
       # جستجوی کد منطبق با "react" و "lifecycle"
       $ gh search code react lifecycle

       # جستجوی کد منطبق با "error handling"
       $ gh search code "error handling"

       # جستجوی کد با استفاده از توصیف‌کننده‌های خام جستجو به عنوان آرگومان‌های مجزا
       $ gh search code panic path:pkg language:go

       # جستجوی کد منطبق با "deque" در فایل‌های پایتون
       $ gh search code deque --language=python

       # جستجوی کد منطبق با "cli" در مخازن متعلق به سازمان microsoft
       $ gh search code cli --owner=microsoft

       # جستجوی کد منطبق با "panic" در مخزن GitHub CLI
       $ gh search code panic --repo cli/cli

       # جستجوی کد منطبق با کلیدواژه "lint" در فایل‌های package.json
       $ gh search code lint --filename package.json




همچنین ببینید (SEE ALSO)
       gh-search(1)

                                   Sep 2026                  GH-SEARCH-CODE(1)