Halaman ini diterjemahkan oleh Cloud Translation API.

Menggunakan penyesuaian kode Gemini Code Assist

Dokumen ini menjelaskan cara menggunakan penyesuaian kode Gemini Code Assist dan memberikan beberapa praktik terbaik. Fitur ini memungkinkan Anda menerima rekomendasi kode, yang diambil dari library internal, API pribadi, dan gaya coding organisasi Anda.

Sebelum memulai

Cara menggunakan penyesuaian kode

Tabel berikut mencantumkan cara menggunakan penyesuaian kode Gemini Code Assist:

Formulir	Cara memicu	Catatan dan referensi
Chat dengan bahasa alami	Masukkan perintah natural language di chat Gemini Code Assist di IDE.	Pertimbangkan hal berikut: Histori chat tidak tersedia. Hindari kueri multi-langkah. Anda dapat meminta detail lebih lanjut tentang sumber, termasuk link ke sumber tertentu. Jika Anda menandai atau memilih kode saat Anda mengirim pesan dalam chat, Gemini Code Assist menggunakan kode tersebut untuk meningkatkan kualitas chat dan penyesuaian kode. Untuk mengetahui informasi selengkapnya, lihat Mulai percakapan dengan Gemini Code Assist.
Buat kode	Di panel pilihan cepat di IDE Anda, dengan atau tanpa kode yang dipilih, tekan `Command+Enter` (di macOS) atau `Control+Enter`.	Untuk mengetahui informasi selengkapnya, lihat Membuat kode dengan perintah.
Transformasi kode	Di kolom pilihan cepat di IDE Anda, dengan atau tanpa kode yang dipilih, masukkan `/fix`.	Untuk mengetahui informasi selengkapnya, lihat Membuat kode dengan perintah.
Pelengkapan Otomatis	Penyesuaian kode dipicu secara otomatis dan memberikan saran berdasarkan apa yang Anda tulis.	Pertimbangkan hal berikut: Penyelesaian kode memerlukan tingkat keyakinan tertentu untuk menyarankan saran. Pastikan sejumlah besar kode tersedia sehingga cuplikan yang relevan dapat diambil. Penyelesaian kode akan memeriksa apakah Anda memiliki library yang diperlukan untuk menggunakan elemen fungsi tertentu. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan penyelesaian kode.
Konteks repositori jarak jauh	Mulai perintah Anda dengan simbol `@`. Daftar repositori jarak jauh yang diindeks akan muncul. Pilih repositori yang ingin Anda gunakan untuk konteks dari daftar. Anda juga dapat mulai mengetik nama repositori untuk memfilter daftar. Setelah memilih repositori, tulis perintah Anda.	Pertimbangkan hal berikut: Hal ini berguna saat Anda mengerjakan tugas yang sebagian besar terkait dengan serangkaian microservice, library, atau modul tertentu. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan saran yang lebih relevan dengan konteks repositori jarak jauh.

Kasus penggunaan dan contoh perintah

Tabel berikut memberikan panduan dan contoh tentang penggunaan penyesuaian kode dalam kasus penggunaan tertentu:

Kasus penggunaan	Hal-hal yang patut dicoba
Menulis kode baru	Coba langkah-langkah berikut untuk membuat kode di IDE atau chat Gemini Code Assist: Buat kode yang akan menggunakan istilah yang sudah disebutkan dalam codebase Anda. Tempelkan kode Anda, seperti tanda tangan fungsional atau kode dengan komentar `TODO`, lalu minta Gemini Code Assist untuk mengisi atau mengganti komentar `TODO` dengan kode. Tambahkan komentar dengan penjelasan dari konteks. Coba buat kode dengan perintah berikut di chat Gemini Code Assist: "Tulis fungsi utama tempat koneksi ke `DATABASE` dibuat. Sertakan health check." "Tulis `FUNCTION_OR_CLASS` dalam struktur berikut: `EXPLAIN_STRUCTURE`." Setelah Anda membuat beberapa kode, coba gunakan perintah lanjutan untuk memperbaikinya: "Coba perintah `/fix` untuk menyesuaikan kode yang dihasilkan—misalnya, error sintaksis." "Tambahkan impor yang tidak ada". "Coba `/fix` pada kode yang dibuat chat."
Membersihkan, menyederhanakan, dan memfaktorkan ulang kode	Coba perintah berikut di chat Gemini Code Assist: "Dapatkah Anda menggabungkan `IMPORTS_VARIABLES_OR_NOTE_EXPORTED_FUNCTIONS` dalam file ini?" "Bagaimana cara menyederhanakan fungsi `FUNCTION_NAME`?" "Dapatkah Anda menggabungkan `FUNCTION_NAME_1` dan `FUNCTION_NAME_2` menjadi satu fungsi?" "Dapatkah Anda menyisipkan beberapa variabel dalam `FUNCTION_NAME`?" "Bisakah Anda menyederhanakan penamaan variabel dalam fungsi `FUNCTION_NAME`?"
Keterbacaan	Coba perintah berikut di chat Gemini Code Assist: "Tulis fungsi `FUNCTION_NAME` dalam baris kode yang lebih sedikit, jika memungkinkan." "Tambahkan komentar ke fungsi `FUNCTION_NAME`." "Hapus spasi yang tidak diperlukan dalam fungsi `FUNCTION_NAME`." "Format fungsi `FUNCTION_NAME` dengan cara yang sama seperti kode lainnya."
Peninjauan kode	Coba perintah berikut di chat Gemini Code Assist: "Pisahkan kode menjadi beberapa bagian dan jelaskan setiap bagian menggunakan codebase kami." "Apakah ada variabel atau kata kunci yang bisa lebih singkat dan lebih jelas?" "Can you give me useful code from the `REPOSITORY_NAME_PACKAGE_MODULE` context for this code?" "Apa pendapat Anda tentang fungsi `FUNCTION_NAME`?"
Proses debug	Coba perintah berikut di chat Gemini Code Assist: "Saya mendapatkan pesan error saat mencoba melakukan X/menambahkan Y. Mengapa?" "Dapatkah Anda menemukan error dalam fungsi `FUNCTION_NAME`?" "Bagaimana cara memperbaiki fungsi `FUNCTION_NAME` mengingat pesan error ini?"
Pembelajaran dan orientasi	Coba perintah berikut di chat Gemini Code Assist: "Split this code in parts and explain each of them using our codebase." (Pisahkan kode ini menjadi beberapa bagian dan jelaskan setiap bagiannya menggunakan codebase kami.) "Tunjukkan cara memanggil fungsi `FUNCTION_NAME`?" "Tunjukkan cara menjalankan fungsi utama di lingkungan `ENVIRONMENT_NAME`?" "What is the key technical improvement we can do to make this code more performant?" (Apa peningkatan teknis utama yang dapat kami lakukan untuk membuat kode ini berperforma lebih baik?) "Tunjukkan kepada saya penerapan `FUNCTION_OR_CLASS_NAME` untuk mendapatkan hasil yang lebih baik dan tambahkan elemen spesifik tersebut"—misalnya, "Tunjukkan kepada saya penerapan fungsi foo di mana foo adalah nama fungsi."
Migrasi	Coba perintah berikut di chat Gemini Code Assist: "Beri saya strategi tentang cara memigrasikan `FILE_NAME` dari `LANGUAGE_1` ke `LANGUAGE_2`"—misalnya, dari Go ke Python. "Mengingat fungsi `FUNCTION_NAME` di repositori `REPOSITORY_NAME`, temukan fungsi yang setara dalam bahasa `LANGUAGE_NAME` yang dapat saya gunakan." Coba alur kerja transformasi berbasis chat atau pembuatan kode berikut menggunakan perintah: "Ambil kode `FILENAME_COMPONENT` yang sudah ditulis dalam `LANGUAGE_1`, lalu refaktorkan dan migrasikan ke `LANGUAGE_2`"—misalnya, dari Go ke Python. Setelah Anda memigrasikan beberapa kode, coba lakukan hal berikut: Pilih bagian yang lebih kecil dan gunakan `/fix` untuk mendapatkannya ke status yang Anda inginkan. Coba perintah berikut: "Apakah ada hal yang dapat ditingkatkan?" "Berikan kemungkinan kendala yang akan dihadapi pengguna." "Bagaimana Anda akan menguji kode ini jika migrasi tersebut benar?"
Membuat dokumentasi	Coba perintah berikut di chat Gemini Code Assist: "Ringkas kode dalam paket atau folder `X` dan berikan dokumentasi untuk lima metode penting teratas." "Buat dokumentasi untuk `FUNCTION_OR_CLASS_NAME`." "Memperpendek dokumentasi sambil mempertahankan informasi penting."
Pembuatan pengujian unit	Coba perintah berikut di chat Gemini Code Assist: "Buat pengujian unit untuk `FILENAME`." "Tambahkan kasus pengujian yang paling relevan untuk fungsi `FUNCTION_NAME`." "Hapus kasus pengujian yang menurut Anda tidak memberikan banyak nilai."

Praktik terbaik

Gunakan nama variabel dan fungsi atau cuplikan kode yang relevan. Panduan ini mengarahkan penyesuaian kode ke contoh kode yang paling relevan.
Gunakan repositori indeks yang ingin Anda skalakan, dan hindari penambahan fungsi yang tidak digunakan lagi. Penyesuaian kode membantu menskalakan gaya kode, pola, semantik kode, pengetahuan, dan penerapan di seluruh codebase. Contoh buruk repositori untuk menskalakan adalah fungsi yang tidak digunakan lagi, kode yang dihasilkan, dan penerapan lama.
Untuk kasus penggunaan pengambilan kode, gunakan fungsi pembuatan kode, bukan penyelesaian kode. Perintah menggunakan bahasa seperti "Dengan menggunakan definisi FUNCTION_NAME, buat fungsi yang persis sama", atau "Buat penerapan FUNCTION_NAME yang persis sama".
Memiliki include atau impor yang ada dalam file untuk kode yang ingin Anda ambil guna meningkatkan kesadaran kontekstual Gemini.
Hanya lakukan satu tindakan untuk setiap perintah. Misalnya, jika Anda ingin mengambil kode dan kode ini diterapkan dalam fungsi baru, lakukan langkah-langkah ini melalui dua perintah.
Untuk kasus penggunaan yang menginginkan lebih dari sekadar kode (seperti penjelasan kode, rencana migrasi, atau penjelasan error), gunakan penyesuaian kode untuk chat, tempat Anda melakukan percakapan dengan Gemini dengan codebase Anda dalam konteks.
Perhatikan bahwa pembuatan model AI bersifat non-deterministik. Jika Anda tidak puas dengan responsnya, menjalankan perintah yang sama lagi dapat memberikan hasil yang lebih baik.
Perhatikan bahwa pembuatan pengujian unit umumnya berfungsi lebih baik jika Anda membuka file secara lokal, lalu dari chat, minta untuk membuat pengujian unit untuk file ini atau fungsi tertentu.

Mendapatkan saran yang lebih relevan dengan konteks repositori jarak jauh

Anda bisa mendapatkan saran kode yang lebih relevan dan sesuai konteks dengan mengarahkan Gemini Code Assist untuk berfokus pada repositori jarak jauh tertentu. Dengan menggunakan simbol @ dalam chat, Anda dapat memilih satu atau beberapa repositori untuk digunakan sebagai sumber utama konteks untuk perintah Anda. Hal ini berguna saat Anda mengerjakan tugas yang sebagian besar terkait dengan serangkaian microservice, library, atau modul tertentu.

Untuk menggunakan repositori jarak jauh sebagai konteks, ikuti langkah-langkah berikut dalam chat IDE Anda:

Mulai perintah Anda dengan simbol @. Daftar repositori jarak jauh yang tersedia dan diindeks akan muncul.
Pilih repositori yang ingin Anda gunakan untuk konteks dari daftar. Anda juga dapat mulai mengetik nama repositori untuk memfilter daftar.
Setelah memilih repositori, tulis perintah Anda.

Kemudian, Gemini akan memprioritaskan repositori yang dipilih saat membuat respons.

Contoh Perintah

Berikut beberapa contoh cara menggunakan fitur ini:

Untuk memahami repositori:
- "@REPOSITORY_NAME Apa struktur keseluruhan repositori ini?"
- "@REPOSITORY_NAME Saya anggota tim baru. Bisakah Anda memberi saya ringkasan tentang tujuan dan modul utama repositori ini?"
Untuk pembuatan dan modifikasi kode:
- "@REPOSITORY_NAME Terapkan fungsi autentikasi yang serupa dengan yang ada di repositori ini."
- "@REPOSITORY_NAME Lakukan refaktor pada kode berikut agar mengikuti konvensi di repositori yang dipilih."
- "@REPOSITORY_A_NAME Bagaimana cara menggunakan fungsi terbaru dari repositori ini untuk meningkatkan kualitas kode saya di REPOSITORY_B_NAME?"
Untuk pengujian:
- "@UNIT_TEST_FILE_NAME Buat pengujian unit untuk MODULE berdasarkan contoh dalam file yang dipilih."

Dengan menggunakan repositori jarak jauh sebagai sumber konteks yang terfokus, Anda bisa mendapatkan saran yang lebih akurat dan relevan dari Gemini Code Assist, yang dapat membantu Anda menulis kode dengan lebih cepat dan efisien.