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ę na temat VS Code lub IntelliJ i innych obsługiwanych środowisk IDE JetBrains. Możesz też użyć 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 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. Skonfiguruj 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. Podczas pisania kodu możesz otrzymywać i akceptować lub odrzucać sugestie dotyczące kodu.

Wskazówki dla Gemini Code Assist dotyczące przekształcania 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:

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+\ (w przypadku systemów Windows i Linux) lub Cmd+\ (w przypadku systemu macOS), aby otworzyć menu Gemini Code Assist – szybki wybór.

  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 wstawianej.

  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ł..

    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.

Otrzymuj trafniejsze sugestie dzięki kontekstowi repozytorium zdalnego

Możesz uzyskać bardziej kontekstowe i trafne sugestie dotyczące kodu, kierując Gemini Code Assist na konkretne repozytoria zdalne. Używając symbolu @ na czacie, możesz wybrać co najmniej 1 repozytorium, które będzie używane jako główne źródło kontekstu dla Twoich promptów. Jest to przydatne, gdy pracujesz nad zadaniem, które jest w większości związane z określonym zestawem mikroserwisów, bibliotek lub modułów.

Aby użyć zdalnego repozytorium jako kontekstu, wykonaj te czynności na czacie w IDE:

  1. Rozpocznij prompt od symbolu @. Pojawi się lista dostępnych zdalnych repozytoriów, które są indeksowane.
  2. Z listy wybierz repozytorium, którego chcesz użyć jako kontekstu. Możesz też zacząć wpisywać nazwę repozytorium, aby przefiltrować listę.
  3. Po wybraniu repozytorium napisz resztę promptu.

Gemini Code Assist będzie wtedy traktować wybrane repozytorium priorytetowo podczas generowania odpowiedzi.

Przykładowe prompty

W tej sekcji znajdziesz przykłady tego, jak uzyskać trafniejsze sugestie dzięki kontekstowi zdalnego repozytorium.

  • Informacje o repozytorium
    • @REPOSITORY_NAME What is the overall structure of this repository?
    • @REPOSITORY_NAME I'm a new team member. Can you give me an overview of this repository's purpose and key modules?
  • Generowanie i modyfikowanie kodu
    • @REPOSITORY_NAME Implement an authentication function similar to the one in this repository.
    • @REPOSITORY_NAME Refactor the following code to follow the conventions in the selected repository.
    • Use the library-x in @REPOSITORY_A_NAME-A and implement the function-x
  • Test
    • @UNIT_TEST_FILE_NAME Generate unit tests for module-x based on the examples in the selected file.

Korzystając z repozytoriów zdalnych jako ukierunkowanego źródła kontekstu, możesz otrzymywać od Gemini Code Assist bardziej trafne i odpowiednie sugestie, które pomogą Ci szybciej i wydajniej pisać kod.

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 odpowiednie działanie.

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 z inteligentnymi działaniami.

  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 inteligentnej czynności spowoduje automatyczne wyświetlenie w oknie narzędzia Gemini Code Assist promptu z prośbą o wygenerowanie odpowiedzi.

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ł:

VS Code

  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ł.

IntelliJ

  1. Na pasku stanu środowiska IDE kliknij spark Gemini Code Assist: Active, a następnie wybierz Configure Gemini (Skonfiguruj Gemini).

  2. Rozwiń sekcję Ustawienia zaawansowane, a potem wybierz Blokuj fragmenty, które pasują do zewnętrznych źródeł cytowanych.

  3. Kliknij OK.

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

Znane problemy

W tej sekcji znajdziesz znane problemy 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 mniejszy fragment 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 recytacji 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ł i Komentarze w formularzu.

  3. W formularzu Opinia o Gemini Code Assist wybierz opcję z menu Kategoria opinii i Typ.

  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?