Pisanie kodu z Gemini Code Assist dla osób prywatnych

Ten dokument opisuje, jak korzystać z Gemini Code Assist, opartej na AI usługi wspomagającej w środowisku IDE, która ułatwi Ci wykonywanie tych czynności w VS Code lub IntelliJ i innych obsługiwanych środowiskach IDE JetBrains:

  • Generuj kod do projektu za pomocą przekształcania kodu.
  • Otrzymuj sugestie uzupełniania kodu podczas pisania.
  • Korzystaj z inteligentnych działań.

Jeśli korzystasz z Gemini Code Assist Enterprise, możesz używać dostosowywania kodu, które umożliwia uzyskiwanie sugestii kodu na podstawie prywatnej bazy kodu organizacji bezpośrednio z Gemini Code Assist Enterprise. Dowiedz się, jak skonfigurować dostosowywanie kodu.

Ten dokument jest przeznaczony dla deweloperów na wszystkich poziomach zaawansowania. Zakłada się, że masz praktyczną wiedzę o VS Code lub IntelliJ i innych obsługiwanych środowiskach IDE JetBrains. Możesz też użyć Gemini w Android Studio.

Zanim zaczniesz

VS Code

  1. skonfigurować Gemini Code Assist dla użytkowników indywidualnych, Gemini Code Assist Standard lub Gemini Code Assist Enterprise, jeśli jeszcze tego nie zrobisz;

  2. Zanim przetestujesz funkcje Gemini Code Assist w pliku z kodem, upewnij się, że 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 serwerem proxy, zapoznaj się z artykułem Połączenia sieciowe w Visual Studio Code.

IntelliJ

  1. skonfigurować Gemini Code Assist dla użytkowników indywidualnych, Gemini Code Assist Standard lub Gemini Code Assist Enterprise, jeśli jeszcze tego nie zrobisz;

  2. Zanim przetestujesz funkcje Gemini Code Assist w pliku z kodem, upewnij się, że 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 serwerem proxy, zapoznaj się z sekcją Serwer proxy HTTP.

Generowanie kodu za pomocą promptów

W kolejnych sekcjach dowiesz się, jak używać Gemini Code Assist do generowania kodu z przykładowym promptem Function to create a Cloud Storage bucket w pliku z kodem. Możesz też wybrać fragment kodu, a następnie poprosić Gemini Code Assist o pomoc za pomocą funkcji czatu oraz otrzymywać i akceptować lub odrzucać sugestie dotyczące kodu podczas pisania.

Wywoływanie Gemini Code Assist za pomocą przekształcenia kodu

Transformacja kodu umożliwia używanie poleceń lub promptów w języku naturalnym w menu szybkiego wyboru w celu poproszenia o zmiany w kodzie. Zapewnia też widok różnic, który pokazuje oczekujące zmiany w kodzie. Aby poprosić Gemini Code Assist o przekształcenie kodu, wykonaj te czynności:

VS Code

  1. W pliku kodu w nowym wierszu naciśnij Ctrl+I (Windows i Linux) lub Command+I (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 systemach Windows i 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 otworzy widok różnic, aby wyświetlić wygenerowany kod.

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

IntelliJ

  1. W pliku kodu w nowym wierszu naciśnij Alt+\ (Windows i Linux) lub Cmd+\ (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 systemach Windows i Linux) lub Return (w systemie macOS).

    Funkcja generowania przekształceń kodu w Gemini Code Assist w IntelliJ

    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 środowisku IDE możesz używać tych poleceń przekształcania kodu:

    • /fix: rozwiąż problemy lub błędy 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.

Wysyłanie promptów do Gemini Code Assist w pliku z kodem za pomocą komentarza

Jeśli wolisz, możesz też wywołać Gemini Code Assist w pliku kodu za pomocą komentarza, wykonując te czynności:

VS Code

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

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

    Obok tekstu prompta w pliku z kodem Gemini Code Assist generuje kod w postaci szarego tekstu.

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

IntelliJ

  1. W pliku z kodem w nowym wierszu wpisz komentarz Function to create a Cloud Storage bucket.

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

    Gemini Code Assist generuje kod pod komentarzem w formie tekstu widma.

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

Opcjonalnie: zmiana skrótu klawiszowego do generowania kodu

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

Uzupełnianie kodu

Podczas pisania kodu Gemini Code Assist wyświetla sugestie kodu w tekście, zwane też uzupełnianiem kodu, które możesz zaakceptować lub zignorować. Aby uzyskać uzupełnianie kodu, wykonaj te czynności:

VS Code

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

    Gemini Code Assist sugeruje kod w formie tekstu widma.

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

IntelliJ

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

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

  2. Aby zaakceptować sugestię kodu od 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 myszy nad sugestią i kliknij wyświetlone menu Tab. Następnie wybierz preferowany skrót lub kliknij Niestandardowy, aby wpisać własny skrót.

    Gemini wyświetla menu, w którym możesz zmienić skrót, aby zaakceptować sugestię wstawianą w tekście.

Opcjonalnie: wyłącz uzupełnianie kodu

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

VS Code

  1. W IDE kliknij Code (macOS) lub File (Windows i Linux), a następnie otwórz Settings > Settings.

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

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

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

IntelliJ

Na pasku stanu IDE kliknijspark Gemini Code Assist: Active (Gemini Code Assist: aktywny) i wybierz Enable AI Code Completion (Włącz uzupełnianie kodu przez AI).

Przycisk uzupełniania kodu przez Gemini na pasku stanu IntelliJ.

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

Korzystanie z inteligentnych działań

Aby zwiększyć produktywność przy jednoczesnym ograniczeniu przełączania kontekstu, Gemini Code Assist udostępnia inteligentne działania oparte na AI bezpośrednio w edytorze kodu. Gdy wybierzesz kod w edytorze, możesz wyświetlić listę działań odpowiednich w danym kontekście i wybrać z niej jedno z nich.

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

VS Code

  1. W pliku z kodem wybierz blok kodu.

  2. Obok wybranego bloku kodu kliknij lightbulb Pokaż działania związane z kodem.

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

  3. Wybierz działanie, np. Generuj testy jednostkowe.

    Gemini Code Assist generuje odpowiedź na podstawie wybranego działania.

IntelliJ

  1. W pliku z kodem wybierz wiersz lub blok kodu.

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

    Wybranie inteligentnego działania spowoduje automatyczne wyświetlenie promptu w Gemini Code Assist, który wygeneruje odpowiedź w oknie narzędzia.

Korzystanie z szybkiej poprawki przekształcenia kodu

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

Aby zastosować szybką poprawkę w pliku z kodem, wykonaj te czynności:

VS Code

  1. W pliku kodu najedź kursorem na linię błędu i wybierz Szybka poprawka, a następnie /fix.

    Szybka poprawka przekształcenia kodu w środowisku IDE.

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

IntelliJ

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

    Opcja transformacji kodu umożliwiająca rozwiązanie problemu za pomocą Gemini w IDE.

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

Wykluczanie plików z kontekstu lokalnego

Domyślnie Gemini Code Assist wyklucza pliki z lokalnego użycia w kontekście uzupełniania kodu, generowania kodu, przekształcania kodu i czatu, jeśli pliki są określone w pliku .aiexclude lub .gitignore.

Aby dowiedzieć się, jak wykluczyć pliki z użycia lokalnego, przeczytaj artykuł Wykluczanie plików z użycia w Gemini Code Assist.

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

Gemini Code Assist podaje informacje o źródle, gdy przytacza bezpośredni 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 pasującego do cytowanych źródeł:

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

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

  3. Przewiń w dół, aż zobaczysz Geminicodeassist > Recitation: Max Cited Length (Geminicodeassist > Recitation: Max Cited Length).

  4. Ustaw wartość na 0.

    Gemini Code Assist nie będzie już sugerować kodu, który pasuje do cytowanych źródeł.

Znane problemy

W tej sekcji znajdziesz informacje o znanych problemach z Gemini Code Assist:

VS Code

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

    Aby obejść ten problem, wybierz mniejszą sekcję kodu i dodaj do promptu na czacie dodatkową dyrektywę, np. only output the selected code.

  • Vim: nie można zaakceptować ani odrzucić sugestii generowania kodu, chyba że w trybie wstawiania

    Gdy używasz wtyczki Vim w trybie normalnym, nie możesz 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ójne działanie po naciśnięciu klawisza Esc w celu odrzucenia sugestii

    Gdy naciśniesz Esc, zostaną odrzucone zarówno sugestie IDE, jak i Gemini Code Assist. To zachowanie różni się od zachowania w przypadku edytora innego niż Vim, w którym naciśnięcie klawisza Esc ponownie aktywuje Gemini Code Assist.

  • Próby logowania ciągle przekraczają limit czasu

    Jeśli próby logowania nadal będą przekraczać limit czasu, spróbuj dodać ustawienie cloudcode.beta.forceOobLogin do pliku settings.json:

     "cloudcode.beta.forceOobLogin": true
    
  • Ostrzeżenia dotyczące recytowania licencji nie są zachowywane między sesjami

    Jeśli ostrzeżenia dotyczące recytacji licencji nie utrzymują się w różnych sesjach, zapoznaj się z trwałymi dziennikami:

    1. Kliknij Widok > Dane wyjściowe.

    2. Wybierz Gemini Code Assist – cytaty.

  • Problemy z łącznością w oknie wyjściowym Gemini Code Assist

    Jeśli w oknie danych wyjściowych funkcji Gemini Code Assist zobaczysz błąd połączenia lub inne problemy z łącznością, wypróbuj te rozwiązania:

    • Skonfiguruj zaporę sieciową, aby zezwalała na dostęp do oauth2.googleapis.com i cloudaicompanion.googleapis.com.

    • Skonfiguruj zaporę sieciową tak, aby zezwalała na komunikację przez HTTP/2, z którego korzysta gRPC.

    Do testowania połączenia możesz użyć narzędzia grpc-health-probe. A Pomyślne sprawdzenie daje te dane wyjściowe:

    $ 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 powoduje wyświetlenie tego komunikatu:

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

    Aby uzyskać więcej informacji, przed uruchomieniem polecenia grpc-health-probe wykonaj to działanie:

    export GRPC_GO_LOG_SEVERITY_LEVEL=info
    

IntelliJ

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

Wyślij opinię

Aby przesłać opinię o swoich wrażeniach, wykonaj te czynności:

VS Code

  1. Możesz przesłać opinię na jeden z tych sposobów:

    • Na pasku stanu kliknij spark Gemini Code Assist, a następnie w menu Szybki wybór wybierz Prześlij opinię.
    • Otwórz paletę poleceń (Ctrl/Command + Shift + P), a następnie wybierz Gemini Code Assist: Send Feedback (Gemini Code Assist: prześlij opinię).
  2. Wypełnij pola TytułKomentarze.

  3. W formularzu Opinia o Gemini Code Assist wybierz opcję z menu Kategoria opiniiTyp.

  4. W polu Komentarz szczegółowo opisz swoje wrażenia.

  5. Pamiętaj, aby w raporcie z opinią uwzględnić logi Gemini Code Assist. Ta opcja jest domyślnie zaznaczona.

  6. Zaznacz lub odznacz inne opcje zgodnie z potrzebami.

  7. Kliknij Prześlij opinię.

IntelliJ

  1. Na pasku stanu kliknij spark Gemini Code Assist.

  2. Po wywołaniu Gemini Code Assist na czacie i jeśli nie jesteś zadowolony(-a) z odpowiedzi, kliknij thumb_down Negatywna, a następnie wybierz Prześlij opinię.

  3. W polu tekstowym u góry formularza wpisz swoją opinię.

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

  5. Kliknij Prześlij opinię.

Co dalej?