Pisanie kodu z Gemini Code Assist dla osób prywatnych

Ten dokument opisuje, jak możesz korzystać z Gemini Code Assist, czyli opartej na AI usługi wspomagającej w Twoim środowisku IDE, aby wykonywać te czynności w VS Code lub IntelliJ i innych obsługiwanych środowiskach IDE JetBrains:

  • Wygeneruj kod dla projektu za pomocą transformacji kodu.
  • otrzymywać propozycje kodu podczas kodowania,
  • Korzystaj z inteligentnych działań.

Jeśli korzystasz z Gemini Code Assist Enterprise, możesz użyć personalizacji kodu, która umożliwia otrzymywanie sugestii kodu na podstawie prywatnej bazy kodu organizacji bezpośrednio z Gemini Code Assist Enterprise. Dowiedz się, jak skonfigurować personalizację kodu.

Ten dokument jest przeznaczony dla deweloperów na każdym poziomie zaawansowania. Zakładamy, że znasz środowisko IDE VS Code lub IntelliJ oraz inne obsługiwane środowiska IDE JetBrains. Możesz też korzystać z Gemini w Android Studio.

Zanim zaczniesz

VS Code

  1. Skonfiguruj Gemini Code Assist dla użytkowników indywidualnych, Gemini Code Assist Standard lub Gemini Code Assist Enterprise, jeśli jeszcze tego nie zrobiono.

  2. Zanim przetestujesz możliwości Gemini Code Assist w pliku kodu, sprawdź, czy język kodowania pliku jest obsługiwany. Więcej informacji o obsługiwanych językach kodowania znajdziesz w artykule Obsługiwane języki kodowania.

  3. Jeśli wolisz używać środowiska IDE za pośrednictwem serwera proxy, zapoznaj się z artykułem Połączenia sieciowe w Visual Studio Code.

IntelliJ

  1. Skonfiguruj Gemini Code Assist dla użytkowników indywidualnych, Gemini Code Assist Standard lub Gemini Code Assist Enterprise, jeśli jeszcze tego nie zrobiono.

  2. Zanim przetestujesz możliwości Gemini Code Assist w pliku kodu, sprawdź, czy język kodowania pliku jest obsługiwany. Więcej informacji o obsługiwanych językach kodowania znajdziesz w artykule Obsługiwane języki kodowania.

  3. Jeśli wolisz używać IDE za pośrednictwem serwera proxy, zapoznaj się z artykułem Serwer proxy HTTP.

Generowanie kodu z promptami

W kolejnych sekcjach dowiesz się, jak użyć Gemini Code Assist do wygenerowania kodu z przykładowym promptem Function to create a Cloud Storage bucket w pliku kodu. Możesz też wybrać część kodu, a potem poprosić Gemini Code Assist o pomoc za pomocą funkcji czatu. Podczas kodowania możesz też akceptować lub odrzucać sugestie dotyczące kodu.

Użycie Gemini Code Assist do przekształcania kodu

Transformacja kodu umożliwia korzystanie z komend lub promptów w języku naturalnym w menu Szybki wybór, aby poprosić o modyfikację kodu. Zapewnia też widok różnic, który pokazuje oczekujące zmiany w kodzie. Aby poprosić Gemini Code Assist o przekształcenie kodu:

VS Code

  1. W pliku kodu na nowej linii naciśnij Control+I (w systemie Windows lub Linux) albo Command+I (w systemie macOS), aby otworzyć menu Szybki wybór Gemini Code Assist.

  2. W menu za pomocą polecenia /generate wpisz /generate function to create a Cloud Storage bucket, a następnie naciśnij Enter (w systemie Windows lub Linux) lub Return (w systemie macOS).

    Gemini Code Assist generuje kod za pomocą polecenia /generate.

    Gemini Code Assist generuje kod na podstawie prompta w widoku różnic.

    Gemini Code Assist otwiera widok różnic, aby wyświetlić wygenerowany kod.

  3. Opcjonalnie: aby zaakceptować te zmiany, kliknij Zaakceptuj.

IntelliJ

  1. W pliku kodu na nowej linii naciśnij Alt + \ (w przypadku systemu Windows lub Linux) albo Cmd + \ (w przypadku systemu macOS), aby otworzyć menu Szybki wybór asystenta kodu Gemini.

  2. W menu za pomocą polecenia /generate wpisz /generate function to create a Cloud Storage bucket, a następnie naciśnij Enter (w systemie Windows i Linux) lub Return (w systemie macOS).

    Funkcja generowania transformacji kodu w IntelliJ Gemini Code Assist

    Gemini Code Assist generuje kod na podstawie prompta w widoku różnic.

    Widok różnic w transformacji kodu w Gemini Code Assist w IntelliJ

  3. Opcjonalnie: aby zaakceptować te zmiany, kliknij Zaakceptuj zmiany.

    W swoim środowisku IDE możesz używać tych poleceń przekształcania kodu:

    • /fix: rozwiązywanie problemów lub błędów w kodzie. Przykład: /fix potential NullPointerExceptions in my code.
    • /generate: wygeneruj kod. Przykład: /generate a function to get the current time.
    • /doc: dodaj dokumentację do kodu. Przykład: /doc this function.
    • /simplify: uprość kod. Przykład: /simplify if statement in this code.

Wywołaj Gemini Code Assist w pliku kodu za pomocą komentarza

Jeśli wolisz, możesz też poprosić Gemini Code Assist o pomoc w pliku kodu, dodając komentarz. Aby to zrobić:

VS Code

  1. Na nowej linii wpisz komentarz Function to create a Cloud Storage bucket, a następnie naciśnij Enter (w systemie Windows i Linux) lub Return (w systemie macOS).

  2. Aby wygenerować kod, naciśnij Control + Enter (w systemie Windows i Linux) lub Control + Return (w systemie macOS).

    Obok promptu w pliku kodu Gemini Code Assist generuje kod w postaci tekstu niewidocznego.

  3. Opcjonalnie: aby zaakceptować wygenerowany kod, naciśnij Tab.

IntelliJ

  1. W pliku kodu na nowej linii wpisz komentarz Function to create a Cloud Storage bucket.

  2. Aby wygenerować kod, naciśnij Alt + G (w systemie Windows i Linux) lub Option + G (w systemie macOS). Możesz też kliknąć prawym przyciskiem myszy obok komentarza i wybrać Generuj kod.

    Gemini Code Assist generuje kod pod Twoim komentarzem w postaci tekstu niewidocznego.

  3. Opcjonalnie: aby zaakceptować wygenerowany kod, naciśnij Tab.

Opcjonalnie: zmień skrót klawiszowy do generowania kodu

Jeśli domyślny skrót klawiszowy do generowania kodu nie działa zgodnie z opisem w poprzedniej sekcji, możesz go zmienić w ten sposób:

VS Code

  1. W swojej IDE kliknij Plik (w przypadku systemu Windows i Linux) lub Kod (w przypadku systemu macOS), a następnie wybierz Ustawienia > Skróty klawiszowe klawiatury.

  2. Na liście skrótów klawiszowych przewiń do sekcji Gemini Code Assist: wygeneruj kod.

  3. Kliknij Gemini Code Assist: wygeneruj kod, a następnie edit Zmień skrót klawiszowy.

  4. W wyświetlonym oknie wpisz własny skrót.

  5. Naciśnij Enter (w systemie Windows lub Linux) lub Return (w systemie macOS).

    Teraz możesz używać nowo przypisanego skrótu klawiszowego do generowania kodu za pomocą Gemini Code Assist.

Więcej informacji o zmianie skrótów w IDE znajdziesz w artykule Kombinacje klawiszy w Visual Studio Code.

IntelliJ

  1. Kliknij settings IDE i ustawienia projektu > Ustawienia > Mapa klawiszy > Gemini Code Assist.

  2. Kliknij prawym przyciskiem myszy Gemini Code Assist i wybierz Dodaj skrót klawiszowy.

  3. Wpisz preferowany skrót klawiszowy i kliknij OK.

  4. Kliknij Gemini Code Assist prawym przyciskiem myszy i wybierz Usuń Alt+G (w przypadku systemu Windows i Linux) lub Usuń Option+G (w przypadku systemu macOS).

Możesz teraz używać nowego skrótu klawiszowego do generowania kodu w pliku kodu.

Pobieranie uzupełnień kodu

Podczas pisania kodu Gemini Code Assist przedstawia sugestie kodu w tekście, zwane też uzupełnianiem kodu. Możesz je zaakceptować lub zignorować. Aby uzyskać uzupełnienie kodu:

VS Code

  1. W pliku kodu na nowym wierszu zacznij pisać funkcję. Jeśli na przykład pracujesz w pliku Pythona, wpisz def.

    Gemini Code Assist sugeruje kod w postaci tekstu niewidocznego.

  2. Aby zaakceptować sugestię kodu z Gemini Code Assist, naciśnij Tab. Aby zignorować sugestię, naciśnij Esc lub kontynuuj pisanie kodu.

IntelliJ

  1. W pliku kodu na nowym wierszu zacznij pisać funkcję. Jeśli na przykład pracujesz w pliku Pythona, wpisz def.

    Gemini Code Assist sugeruje kod w postaci sugestii w tekście.

  2. Aby zaakceptować sugestię kodu z Gemini Code Assist, naciśnij Tab. Aby zignorować sugestię, naciśnij Esc lub kontynuuj pisanie kodu.

  3. Opcjonalnie: jeśli wolisz użyć innego klawisza skrótu, aby zaakceptować sugestię w tekście, umieść wskaźnik na sugestii w tekście i kliknij Tab. Następnie wybierz preferowany skrót lub kliknij Niestandardowy, aby wpisać własny skrót.

    Gemini udostępnia menu, w którym możesz zmienić skrót, aby zaakceptować sugestię w tekście.

Opcjonalnie: wyłącz uzupełnianie kodu

Uzupełnianie kodu jest domyślnie włączone. Jeśli chcesz wyłączyć autouzupełnianie kodu, wykonaj te czynności:

VS Code

  1. W swojej IDE kliknij Kod (w przypadku systemu macOS) lub Plik (w przypadku systemu Windows lub Linux), a potem otwórz Ustawienia > Ustawienia.

  2. Na karcie Użytkownik w oknie Ustawienia kliknij Rozszerzenia > Gemini Code Assist.

  3. Przewiń, aż znajdziesz listę Duet AI: Sugerowane zmiany w tekście: Włącz automatyczne, a następnie wybierz Wył.

    Spowoduje to wyłączenie sugestii w tekście. Nadal możesz nacisnąć Control + Enter (w Windows i Linux) lub Control + Return (w macOS), aby ręcznie wywołać sugestie w ramce.

IntelliJ

Na pasku stanu edytora kliknij spark Gemini Code Assist: Aktywny i wybierz Włącz uzupełnianie kodu przez AI.

Przycisk Uzupełnianie kodu przez Gemini na pasku stanu IntelliJ

Spowoduje to wyłączenie ustawienia uzupełniania kodu. Gemini Code Assist nie będzie już wyświetlać sugestii w tekście, dopóki nie włączysz tego ustawienia ponownie.

Korzystanie z inteligentnych działań

Aby pomóc Ci zwiększyć produktywność przy jednoczesnym minimalizowaniu potrzeby przełączania kontekstu, Gemini Code Assist udostępnia inteligentne działania oparte na AI bezpośrednio w edytorze kodu. Po wybraniu kodu w edytorze kodu możesz wyświetlić listę działań odpowiednich dla Twojego kontekstu i wybrać jedno z nich.

Aby używać inteligentnych działań w kodzie, wykonaj te czynności:

VS Code

  1. W pliku kodu wybierz blok kodu.

  2. Obok wybranego bloku kodu kliknij lightbulb Pokaż kod.

    Po wybraniu bloku kodu w VS Code pojawia się ikona żarówki inteligentnych działań.

  3. Wybierz działanie, np. Generowanie testów jednostkowych.

    Gemini Code Assist generuje odpowiedź na podstawie wybranej przez Ciebie czynności.

IntelliJ

  1. W pliku kodu wybierz wiersz lub blok kodu.

  2. Kliknij prawym przyciskiem myszy wybrany kod i wybierz inteligentne działanie, np. Wygeneruj testy jednostkowe.

    Wybranie inteligentnego działania spowoduje automatyczne wygenerowanie przez Gemini Code Assist odpowiedzi na prompt w oknie narzędzia Gemini Code Assist.

Szybkie rozwiązanie problemu z przekształceniem kodu

Jeśli w Twoim kodzie wystąpi błąd, Gemini Code Assist umożliwia zastosowanie szybkiej poprawki, która przekształci kod.

Aby zastosować szybkie rozwiązanie w pliku kodu:

VS Code

  1. W pliku kodu najedź kursorem na falowane okienko z błędem, a potem kliknij Szybka poprawka, a następnie /fix.

    Szybka poprawka transformacji kodu w IDE.

  2. Po zastosowaniu szybkiego rozwiązania pojawi się widok różnic. Aby zaakceptować te zmiany, kliknij Zaakceptuj.

IntelliJ

  1. W pliku kodu kliknij czerwoną ikonę żarówki, która wskazuje błąd w kodzie, i wybierz Popraw za pomocą Gemini.

    Opcja konwersji kodu, która umożliwia naprawianie błędów za pomocą Gemini w IDE.

  2. Po zastosowaniu poprawki pojawi się widok różnic. Aby zaakceptować te zmiany, kliknij Zaakceptuj.

Wyłączanie sugestii kodu pasujących do cytowanych źródeł

Gemini Code Assist podaje informacje o cytacie, gdy przytacza długi cytat z innego źródła, np. z istniejącego kodu open source. Więcej informacji znajdziesz w artykule Jak i kiedy Gemini podaje źródła.

Aby zapobiec sugerowaniu kodu, który pasuje do cytowanych źródeł:

  1. Na pasku aktywności w IDE kliknij Zarządzaj > Ustawienia.

  2. W oknie ustawień na karcie Użytkownik kliknij Rozszerzenia > Gemini Code Assist.

  3. Przewiń w dół, aż zobaczysz Duet AI > Recitation: Max Cited Length (Duet AI > Recytacja: maksymalna długość cytatu).

  4. Ustaw wartość na 0.

    Gemini Code Assist nie sugeruje już kodu, który pasuje do cytowanych źródeł.

Znane problemy

W tej sekcji omówiliśmy znane problemy z Gemini Code Assist:

VS Code

  • Odpowiedzi na czacie mogą zostać obcięte, jeśli zawierają zaktualizowaną wersję dużego otwartego pliku

    Aby obejść ten problem, wybierz mniejszy fragment kodu i dodaj dodatkową instrukcję w promptu czatu, na przykład only output the selected code.

  • Vim: nie można zaakceptować ani odrzucić sugestii dotyczącej generowania kodu, chyba że jest włączony tryb wstawiania

    Podczas korzystania z wtyczki Vim w trybie normalnym nie można akceptować ani odrzucać sugestii kodu.

    Aby obejść ten problem, naciśnij i, aby przejść do trybu wstawiania, a następnie naciśnij Tab, aby zaakceptować sugestię.

  • Vim: niespójność działania po naciśnięciu Esc w celu odrzucenia sugestii

    Gdy naciśniesz Esc, sugestie IDE i Gemini Code Assist zostaną odrzucone. To zachowanie różni się od zachowania w przypadku innych przeglądarek niż Vim, w których naciśnięcie klawisza Esc ponownie uruchamia Gemini Code Assist.

  • Próby logowania się są przerywane przez limit czasu

    Jeśli próby logowania się są ciągle przerywane, spróbuj dodać ustawienie cloudcode.beta.forceOobLogin do pliku settings.json:

     "cloudcode.beta.forceOobLogin": true
    
  • Ostrzeżenia dotyczące odczytania licencji nie są zachowywane w kolejnych sesjach

    Jeśli ostrzeżenia o wymowie licencji nie są zachowywane w przypadku kolejnych sesji, zapoznaj się z trwałymi logami:

    1. Kliknij Widok > Wyjście.

    2. Wybierz Gemini Code Assist – cytaty.

  • Problemy z połączeniem w oknie wyników Gemini Code Assist

    Jeśli w oknie wyjściowym Gemini Code Assist zobaczysz błąd połączenia lub inne problemy z połączeniem, wykonaj te czynności:

    • Skonfiguruj zaporę sieciową, aby zezwolić na dostęp do adresów oauth2.googleapis.com i cloudaicompanion.googleapis.com.

    • Skonfiguruj zaporę sieciową tak, aby zezwalała na komunikację przez HTTP/2, której używa gRPC.

    Aby przetestować połączenie, możesz użyć narzędzia grpc-health-probe. Pomyślna kontrola kończy się wyświetleniem następujących danych wyjściowych:

    $ 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

    Nieudana weryfikacja spowoduje wyświetlenie tego komunikatu:

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

    Aby uzyskać więcej informacji, przed poleceniem grpc-health-probe wykonaj te czynności:

    export GRPC_GO_LOG_SEVERITY_LEVEL=info
    

IntelliJ

Nie ma żadnych znanych problemów z Gemini Code Assist w IntelliJ i innych obsługiwanych środowiskach IDE JetBrains.

Wyślij opinię

Aby przesłać opinię o spotkaniu:

VS Code

  1. Na pasku stanu kliknij spark Gemini Code Assist, a następnie w menu Szybki wybór wybierz Prześlij opinię.

  2. W formularzu wypełnij pola Tytuł i Komentarze.

  3. Jeśli chcesz udostępnić logi Skaffold lub AI Companion, wybierz opcję Wyślij logi Skaffold lub Wyślij logi AI Companion.

  4. Kliknij Prześlij opinię.

IntelliJ

  1. Na pasku stanu kliknij spark Gemini Code Assist, a następnie w menu wybierz Prześlij opinię.

  2. W polu tekstowym u góry formularza wpisz opinię.

  3. Jeśli chcesz udostępnić logi Gemini Code Assist, wybierz pliki logów.

  4. Kliknij Prześlij opinię.

Co dalej?