کد با Gemini Code Assist برای افراد

این سند توضیح می‌دهد که چگونه می‌توانید از Gemini Code Assist ، یک همکار مبتنی بر هوش مصنوعی در IDE خود استفاده کنید تا به شما در انجام کارهای زیر در VS Code یا IntelliJ و سایر IDE‌های JetBrains پشتیبانی‌شده کمک کند:

  • کد برای پروژه خود با تبدیل کد ایجاد کنید.
  • زمانی که در حال کدنویسی هستید، تکمیل کدها را دریافت کنید.
  • از اقدامات هوشمندانه استفاده کنید.

اگر از Gemini Code Assist Enterprise استفاده می‌کنید، می‌توانید از سفارشی‌سازی کد استفاده کنید، که به شما امکان می‌دهد پیشنهادات کد را بر اساس پایگاه کد خصوصی سازمانتان مستقیماً از Gemini Code Assist Enterprise دریافت کنید. نحوه پیکربندی سفارشی سازی کد را بیاموزید.

این سند برای توسعه دهندگان در تمام سطوح مهارت در نظر گرفته شده است. فرض بر این است که شما دانش کاری VS Code یا IntelliJ و سایر IDE های JetBrains پشتیبانی شده دارید. همچنین می توانید از Gemini در Android Studio استفاده کنید.

قبل از شروع

کد VS

  1. اگر قبلاً این کار را نکرده‌اید، Gemini Code Assist را برای افراد، Gemini Code Assist Standard یا Gemini Code Assist Enterprise تنظیم کنید .

  2. قبل از آزمایش قابلیت‌های Gemini Code Assist در فایل کد خود، مطمئن شوید که زبان کدنویسی فایل شما پشتیبانی می‌شود. برای اطلاعات بیشتر در مورد زبان‌های کدنویسی پشتیبانی شده، به زبان‌های کدنویسی پشتیبانی شده مراجعه کنید.

  3. اگر ترجیح می دهید از IDE خود در پشت پراکسی استفاده کنید، به اتصالات شبکه در کد ویژوال استودیو مراجعه کنید.

IntelliJ

  1. اگر قبلاً این کار را نکرده‌اید، Gemini Code Assist را برای افراد، Gemini Code Assist Standard یا Gemini Code Assist Enterprise تنظیم کنید .

  2. قبل از آزمایش قابلیت‌های Gemini Code Assist در فایل کد خود، مطمئن شوید که زبان کدنویسی فایل شما پشتیبانی می‌شود. برای اطلاعات بیشتر در مورد زبان‌های کدنویسی پشتیبانی شده، به زبان‌های کدنویسی پشتیبانی شده مراجعه کنید.

  3. اگر ترجیح می دهید از IDE خود در پشت پراکسی استفاده کنید، به پروکسی HTTP مراجعه کنید.

ایجاد کد با دستورات

بخش‌های زیر به شما نشان می‌دهند که چگونه از Gemini Code Assist برای تولید کد با مثال Function to create a Cloud Storage bucket در داخل فایل کد خود استفاده کنید. همچنین می‌توانید بخشی از کد خود را انتخاب کنید و سپس از Gemini Code Assist از طریق ویژگی چت کمک بخواهید، و هنگام کدنویسی پیشنهادات کد را دریافت و قبول یا رد کنید.

کمک به کد Gemini با تبدیل کد

تبدیل کد به شما این امکان را می دهد که از دستورات یا دستورات زبان طبیعی در منوی انتخاب سریع برای درخواست تغییرات در کد خود استفاده کنید و یک نمای متفاوت برای نمایش تغییرات معلق در کدتان در اختیار شما قرار می دهد. برای درخواست Gemini Code Assist با تبدیل کد، مراحل زیر را دنبال کنید:

کد VS

  1. در فایل کد خود، در یک خط جدید، Control+I (برای ویندوز و لینوکس) یا Command+I (برای macOS) را فشار دهید تا منوی Gemini Code Assist Quick Pick باز شود.

  2. در منو، با استفاده از فرمان /generate ، /generate function to create a Cloud Storage bucket وارد کنید و سپس Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

    Gemini Code Assist با دستور /generate کد تولید می کند.

    Gemini Code Assist کد را بر اساس درخواست شما در نمای متفاوت تولید می کند.

    Gemini Code Assist یک نمای متفاوت برای نمایش کد تولید شده باز می کند.

  3. اختیاری: برای پذیرش این تغییرات، روی Accept کلیک کنید.

IntelliJ

  1. در فایل کد خود، در یک خط جدید، Alt+\ (برای ویندوز و لینوکس) یا Cmd+\ (برای macOS) را فشار دهید تا منوی Gemini Code Assist Quick Pick باز شود.

  2. در منو، با استفاده از فرمان /generate ، /generate function to create a Cloud Storage bucket وارد کنید و سپس Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

    تبدیل کد عملکردی را در IntelliJ Gemini Code Assist ایجاد می کند

    Gemini Code Assist کد را بر اساس درخواست شما در نمای متفاوت تولید می کند.

    نمای تغییر تغییر کد در IntelliJ Gemini Code Assist

  3. اختیاری: برای پذیرش این تغییرات، روی Accept Changes کلیک کنید.

    می توانید از دستورات تبدیل کد زیر در IDE خود استفاده کنید:

    • /fix : مشکلات یا خطاهای کد خود را برطرف کنید. مثال: /fix potential NullPointerExceptions in my code .
    • /generate : ایجاد کد. مثال: /generate a function to get the current time .
    • /doc : اسناد را به کد خود اضافه کنید. مثال: /doc this function .
    • /simplify : کد خود را ساده کنید. مثال: /simplify if statement in this code .

از Gemini Code Assist در یک فایل کد با یک نظر توضیح دهید

اگر ترجیح می‌دهید، می‌توانید با دنبال کردن مراحل زیر، از Gemini Code Assist در فایل کد خود با یک نظر درخواست کنید:

کد VS

  1. در یک خط جدید، Function to create a Cloud Storage bucket و سپس Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

  2. برای تولید کد، Control+Enter (برای ویندوز و لینوکس) یا Control+Return (برای macOS) را فشار دهید.

    در کنار متن درخواستی شما در فایل کدتان، Gemini Code Assist کد را به شکل متن شبح تولید می کند.

  3. اختیاری: برای پذیرش کد تولید شده، Tab را فشار دهید.

IntelliJ

  1. در فایل کد خود، در یک خط جدید، Function to create a Cloud Storage bucket .

  2. برای تولید کد، Alt+G (برای ویندوز و لینوکس) یا Option+G (برای macOS) را فشار دهید. یا می‌توانید در کنار نظر کلیک راست کرده و Generate Code را انتخاب کنید.

    Gemini Code Assist کد زیر نظر شما را به شکل متن شبح تولید می کند.

  3. اختیاری: برای پذیرش کد تولید شده، Tab را فشار دهید.

اختیاری: میانبر صفحه کلید را برای تولید کد تغییر دهید

اگر میانبر پیش‌فرض صفحه‌کلید برای تولید کد، همانطور که در بخش قبل توضیح داده شد، کار نمی‌کند، می‌توانید با دنبال کردن این مراحل، میان‌بر صفحه‌کلید را تغییر دهید:

کد VS

  1. در IDE خود، روی File (برای Windows و Linux) یا Code (برای macOS) کلیک کنید و سپس به تنظیمات > میانبرهای صفحه کلید بروید.

  2. در لیست میانبرهای صفحه کلید، پیمایش کنید تا Gemini Code Assist: Generate code را پیدا کنید.

  3. روی Gemini Code Assist: Generate Code کلیک کنید و سپس روی edit Change Keybinding کلیک کنید.

  4. در گفتگوی ظاهر شده، میانبر خود را وارد کنید.

  5. Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

    اکنون می توانید از میانبر صفحه کلید جدید اختصاص داده شده خود برای تولید کد با Gemini Code Assist استفاده کنید.

برای کسب اطلاعات بیشتر در مورد تغییر میانبرها در IDE خود، به Keybindings for Visual Studio Code مراجعه کنید.

IntelliJ

  1. به settings IDE و Project Settings > Settings > Keymap > Gemini Code Assist بروید.

  2. روی Gemini Code Assist کلیک راست کرده و Add Keyboard Shortcut را انتخاب کنید.

  3. میانبر صفحه کلید دلخواه خود را وارد کنید و سپس روی OK کلیک کنید.

  4. روی Gemini Code Assist راست کلیک کرده و Remove Alt+G (برای ویندوز و لینوکس) یا Remove Option+G (برای macOS) را انتخاب کنید.

اکنون می توانید از میانبر صفحه کلید جدید خود برای تولید کد در یک فایل کد استفاده کنید.

تکمیل کدها را دریافت کنید

هنگام نوشتن کد، Gemini Code Assist کدهای درون خطی را پیشنهاد می کند که به عنوان تکمیل کد نیز شناخته می شود، که می توانید آنها را بپذیرید یا نادیده بگیرید. برای دریافت تکمیل کد، مراحل زیر را دنبال کنید:

کد VS

  1. در فایل کد خود، در یک خط جدید، شروع به نوشتن یک تابع کنید. برای مثال، اگر در یک فایل پایتون هستید، def بنویسید.

    Gemini Code Assist کدی را به شکل متن شبح پیشنهاد می کند.

  2. برای پذیرش پیشنهاد کد از Gemini Code Assist، Tab را فشار دهید. در غیر این صورت، برای نادیده گرفتن پیشنهاد، Esc را فشار دهید یا به نوشتن کد خود ادامه دهید.

IntelliJ

  1. در فایل کد خود، در یک خط جدید، شروع به نوشتن یک تابع کنید. برای مثال، اگر در یک فایل پایتون هستید، def بنویسید.

    Gemini Code Assist کد را در قالب یک پیشنهاد درون خطی پیشنهاد می کند.

  2. برای پذیرش پیشنهاد کد از Gemini Code Assist، Tab را فشار دهید. در غیر این صورت، برای نادیده گرفتن پیشنهاد، Esc را فشار دهید یا به نوشتن کد خود ادامه دهید.

  3. اختیاری: اگر ترجیح می دهید از کلید میانبر دیگری برای پذیرش پیشنهاد درون خطی استفاده کنید، نشانگر خود را روی پیشنهاد درون خطی نگه دارید و روی منوی کشویی Tab که ظاهر می شود کلیک کنید. سپس، میانبر مورد نظر خود را انتخاب کنید یا روی Custom کلیک کنید تا میانبر خود را وارد کنید.

    Gemini یک منوی کشویی برای تغییر میانبر شما برای پذیرش یک پیشنهاد درون خطی ارائه می دهد.

اختیاری: تکمیل کد را غیرفعال کنید

تکمیل کد به طور پیش فرض فعال است. اگر می خواهید تکمیل کد را غیرفعال کنید، این مراحل را دنبال کنید:

کد VS

  1. در IDE خود، روی Code (برای macOS) یا File (برای Windows و Linux) کلیک کنید و سپس به Settings > Settings بروید.

  2. در برگه کاربر در گفتگوی تنظیمات ، به Extensions > Gemini Code Assist بروید.

  3. پیمایش کنید تا Duet AI: Inline Suggestions: Enable Auto list را بیابید و سپس Off را انتخاب کنید.

    این پیشنهادات درون خطی را خاموش می کند. همچنان می توانید Control+Enter (برای ویندوز و لینوکس) یا Control+Return (برای macOS) را فشار دهید تا به صورت دستی پیشنهادات درون خطی را فعال کنید.

IntelliJ

در نوار وضعیت IDE خود، روی spark Gemini Code Assist: Active کلیک کنید و Enable AI Code Completion را انتخاب کنید.

دکمه تکمیل کد Gemini در نوار وضعیت IntelliJ.

این تنظیمات تکمیل کد را غیرفعال می‌کند و Gemini Code Assist دیگر پیشنهادات درون خطی ارائه نمی‌کند تا زمانی که تنظیم را دوباره فعال کنید.

از اقدامات هوشمندانه استفاده کنید

Gemini Code Assist برای کمک به بهره‌وری بیشتر و در عین حال به حداقل رساندن تغییر زمینه، اقدامات هوشمند مبتنی بر هوش مصنوعی را مستقیماً در ویرایشگر کد شما ارائه می‌کند. هنگامی که کد خود را در ویرایشگر کد خود انتخاب می کنید، می توانید لیستی از اقدامات مرتبط با زمینه خود را مشاهده و انتخاب کنید.

برای استفاده از اقدامات هوشمند در کد خود، این مراحل را دنبال کنید:

کد VS

  1. در فایل کد خود، یک بلوک کد را انتخاب کنید.

  2. در کنار بلوک کد انتخاب شده، lightbulb نمایش اقدامات کد کلیک کنید.

    نماد لامپ اقدامات هوشمند پس از انتخاب یک بلوک کد در VS Code ظاهر می شود.

  3. اقدامی مانند Generate unit tests را انتخاب کنید.

    Gemini Code Assist پاسخی را ایجاد می‌کند که بر اساس عملکردی است که انتخاب کرده‌اید.

IntelliJ

  1. در فایل کد خود، یک خط یا بلوک کد را انتخاب کنید.

  2. روی کد انتخاب شده کلیک راست کرده و یک اقدام هوشمند مانند Generate unit tests را انتخاب کنید.

    انتخاب کنش هوشمند به طور خودکار از Gemini Code Assist درخواست می‌کند تا در پنجره ابزار Gemini Code Assist به درخواست پاسخ دهد.

از اصلاح سریع تبدیل کد استفاده کنید

اگر خطایی در کد شما وجود داشته باشد، Gemini Code Assist به شما این امکان را می دهد که با تبدیل کد، یک اصلاح سریع برای خطا اعمال کنید.

برای اعمال یک رفع سریع در فایل کد خود، این مراحل را دنبال کنید:

کد VS

  1. در فایل کد خود، نشانگر خود را روی خط خطای squiggly نگه دارید و Quick Fix را انتخاب کنید و سپس /fix را انتخاب کنید.

    رفع سریع تبدیل کد در IDE.

  2. هنگامی که رفع سریع اعمال می شود، نمای تفاوت ظاهر می شود. برای پذیرش این تغییرات، روی Accept کلیک کنید.

IntelliJ

  1. در فایل کد خود، روی نماد لامپ خطای قرمز رنگ که نشان دهنده خطای کد شما است، کلیک کنید و گزینه Fix with Gemini را انتخاب کنید.

    گزینه تبدیل کد برای اصلاح با Gemini در IDE.

  2. هنگامی که اصلاح اعمال می شود، یک نمای تفاوت ظاهر می شود. برای پذیرش این تغییرات، روی Accept کلیک کنید.

پیشنهادات کدی را که با منابع ذکر شده مطابقت دارند غیرفعال کنید

Gemini Code Assist زمانی که مستقیماً از منبع دیگری مانند کد منبع باز موجود نقل قول می کند، اطلاعات نقل قول را ارائه می دهد. برای اطلاعات بیشتر، به نحوه و زمان استناد جمینی به منابع مراجعه کنید.

برای جلوگیری از پیشنهاد کدی که با منابع ذکر شده مطابقت دارد، موارد زیر را انجام دهید:

  1. در نوار فعالیت IDE خود، روی مدیریت > تنظیمات کلیک کنید.

  2. در برگه کاربر پنجره تنظیمات، به Extensions > Gemini Code Assist بروید.

  3. پیمایش کنید تا Duet AI > Recitation: Max Cited Length را پیدا کنید.

  4. مقدار را روی 0 قرار دهید.

    Gemini Code Assist دیگر کدی را به شما پیشنهاد نمی کند که با منابع ذکر شده مطابقت داشته باشد.

مسائل شناخته شده

این بخش به تشریح مسائل شناخته شده Gemini Code Assist می پردازد:

کد VS

  • پاسخ‌های گپ زمانی که شامل نسخه به‌روزرسانی‌شده یک فایل باز بزرگ باشد، ممکن است کوتاه شوند

    برای حل این مشکل، بخش کوچکتری از کد را انتخاب کنید و یک دستورالعمل اضافی را در اعلان چت قرار دهید، مانند only output the selected code.

  • Vim: نمی‌تواند پیشنهادهای تولید کد را بپذیرد یا رد کند مگر اینکه در حالت درج باشد

    هنگام استفاده از افزونه Vim در حالت عادی، نمی توانید پیشنهادات کد را بپذیرید یا رد کنید.

    برای حل این مشکل، i را فشار دهید تا وارد حالت درج شوید و سپس Tab را فشار دهید تا پیشنهاد را بپذیرید.

  • Vim: رفتار ناسازگار هنگام فشار دادن Esc برای رد پیشنهادها

    وقتی Esc را فشار می‌دهید، هر دو پیشنهاد IDE و Gemini Code Assist رد می‌شوند. این رفتار متفاوت از رفتار غیر Vim است که در آن فشار دادن Esc دوباره Gemini Code Assist را فعال می‌کند.

  • تلاش برای ورود به سیستم به پایان می رسد

    اگر تلاش‌های ورود به سیستم شما به پایان می‌رسد، سعی کنید تنظیم cloudcode.beta.forceOobLogin را به فایل settings.json خود اضافه کنید:

     "cloudcode.beta.forceOobLogin": true

  • هشدارهای تلاوت مجوز در تمام جلسات ادامه نمی‌یابد

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

    1. روی View > Output کلیک کنید.

    2. Gemini Code Assist - Citations را انتخاب کنید.

  • مشکلات اتصال در پنجره خروجی Gemini Code Assist

    اگر خطای اتصال یا سایر مشکلات اتصال را در پنجره خروجی Gemini Code Assist مشاهده کردید، موارد زیر را امتحان کنید:

    • فایروال خود را برای اجازه دسترسی به oauth2.googleapis.com و cloudaicompanion.googleapis.com پیکربندی کنید.

    • فایروال خود را طوری پیکربندی کنید که امکان برقراری ارتباط از طریق HTTP/2، که gRPC از آن استفاده می کند، فراهم کند.

    می توانید از ابزار grpc-health-probe برای تست اتصال استفاده کنید. یک بررسی موفقیت آمیز به خروجی زیر منجر می شود:

    $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

    یک بررسی ناموفق به خروجی زیر منجر می شود:

    timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

    برای به دست آوردن جزئیات بیشتر، موارد زیر را قبل از grpc-health-probe اجرا کنید:

    export GRPC_GO_LOG_SEVERITY_LEVEL=info

IntelliJ

هیچ مشکل شناخته شده ای برای Gemini Code Assist برای IntelliJ و سایر IDE های JetBrains پشتیبانی شده وجود ندارد.

بازخورد بگذارید

برای ارائه بازخورد از تجربه خود، این مراحل را دنبال کنید:

کد VS

  1. در نوار وضعیت، روی spark Gemini Code Assist کلیک کنید و سپس در منوی Quick Pick ، Send feedback را انتخاب کنید.

  2. در فرم، فیلدهای عنوان و نظرات را پر کنید.

  3. اگر می خواهید سیاهههای Skaffold یا AI Companion خود را به اشتراک بگذارید، مطمئن شوید که گزینه Send Skaffold logs یا Send AI Companion logs را انتخاب کرده اید.

  4. روی ارسال بازخورد کلیک کنید.

IntelliJ

  1. در نوار وضعیت، روی spark Gemini Code Assist کلیک کنید و سپس در منو، ارسال بازخورد را انتخاب کنید.

  2. در قسمت متن بالای فرم، بازخورد خود را وارد کنید.

  3. اگر می‌خواهید گزارش‌های Gemini Code Assist خود را به اشتراک بگذارید، مطمئن شوید که فایل‌های گزارش را انتخاب کرده‌اید.

  4. روی ارسال بازخورد کلیک کنید.

بعدش چی