.nh
.TH "GH-SEARCH-CODE" "1" "Sep 2026" "" "GitHub CLI manual"

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


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh search code <query> [flags]\fR


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

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

\[la]https://docs.github.com/search\-github/searching\-on\-github/searching\-code\[ra]

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

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


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--extension\fR \fB<string>\fR
فیلتر کردن بر اساس پسوند فایل

.TP
\fB--filename\fR \fB<string>\fR
فیلتر کردن بر اساس نام فایل

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

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

.TP
\fB--language\fR \fB<string>\fR
فیلتر کردن نتایج بر اساس زبان

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

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

.TP
\fB--owner\fR \fB<strings>\fR
فیلتر کردن بر اساس مالک

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

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

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

.TP
\fB-w\fR, \fB--web\fR
باز کردن عبارت جستجو در مرورگر وب


.SH "فیلدهای JSON (JSON FIELDS)"
\fBpath\fR, \fBrepository\fR, \fBsha\fR, \fBtextMatches\fR, \fBurl\fR


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# جستجوی کد منطبق با "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

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBgh-search(1)\fR