Korzystanie z dostosowywania kodu w Gemini Code Assist

Ten dokument opisuje, jak korzystać z dostosowywania kodu Gemini Code Assist, oraz podaje kilka sprawdzonych metod. Ta funkcja umożliwia otrzymywanie rekomendacji dotyczących kodu, które korzystają z bibliotek wewnętrznych, prywatnych interfejsów API i stylu kodowania Twojej organizacji.

Zanim zaczniesz

  1. Skonfiguruj Gemini Code Assist za pomocą subskrypcji Enterprise.
  2. Skonfiguruj dostosowywanie kodu w Gemini Code Assist za pomocą subskrypcji Enterprise.

Jak korzystać z personalizacji kodu

W tabeli poniżej znajdziesz sposoby dostosowywania kodu za pomocą Gemini Code Assist:

Formularz Jak wywołać Uwagi i materiały

Czat w języku naturalnym

Wpisz prompt w języku naturalnym w Gemini Code Assist na czacie w IDE.

Weź pod uwagę następujące kwestie:

  • Historia czatu jest niedostępna. Unikaj zapytań wieloetapowych.
  • Możesz poprosić o dodatkowe informacje o źródłach, w tym o linki do konkretnych źródeł.
  • Jeśli podczas wysyłania wiadomości na czacie wyróżnisz lub wybierzesz kod, Gemini Code Assist użyje go do ulepszenia dostosowywania kodu i jakości czatu.

Więcej informacji znajdziesz w artykule Rozmowy z Gemini Code Assist.

Generowanie kodu Na pasku szybkiego wyboru w IDE (z wybranym kodem lub bez niego) naciśnij Command + Enter (w systemie macOS) lub Control + Enter. Więcej informacji znajdziesz w artykule Generowanie kodu z promptami.
Przekształcanie kodu W pasku szybkiego wyboru w IDE (z wybranym kodem lub bez niego) wpisz /fix. Więcej informacji znajdziesz w artykule Generowanie kodu z promptami.
Autouzupełnianie Personalizacja kodu jest uruchamiana automatycznie i zawiera sugestie na podstawie tego, co piszesz.

Weź pod uwagę następujące kwestie:

  • Do zaproponowania sugestii kod potrzebuje określonego poziomu ufności. Upewnij się, że dostępna jest znaczna ilość kodu, aby można było pobrać odpowiednie fragmenty kodu.
  • W ramach funkcji autouzupełniania kodu sprawdzamy, czy masz wymagane biblioteki, aby móc używać określonych elementów funkcji.

Więcej informacji znajdziesz w artykule Uzyskiwanie funkcji autouzupełniania kodu.

Przypadki użycia i przykłady promptów

W tabeli poniżej znajdziesz wskazówki i przykłady dotyczące dostosowywania kodu do konkretnych zastosowań:

Przypadek użycia Co warto wypróbować
Tworzenie nowego kodu

Aby wygenerować kod w IDE lub na czacie Gemini Code Assist, wykonaj te czynności:

  • wygenerować kod, który używa terminów już występujących w Twoim kodzie źródłowym;
  • Wklej kod, np. sygnaturę funkcjonalną lub kod z komentarzami TODO, a następnie poproś Gemini Code Assist o wypełnienie lub zastąpienie komentarzy TODO kodem. Dodawanie komentarzy z wyjaśnieniami na podstawie kontekstu.

Spróbuj wygenerować kod, korzystając z tych promptów w czacie Gemini Code Assist:

  • „Napisz funkcję główną, w której tworzone jest połączenie z funkcją DATABASE. zawierać kontroli stanu.
  • „Napisz FUNCTION_OR_CLASS w następującej strukturze: EXPLAIN_STRUCTURE”.

Po wygenerowaniu kodu spróbuj użyć dodatkowego prompta, aby go ulepszyć:

  • „Aby dostosować wygenerowany kod, na przykład w przypadku błędów składniowych, użyj polecenia /fix”.
  • „Dodaj brakujące importy”.
  • „Wypróbuj /fix w przypadku kodu wygenerowanego na czacie”.
Czyszczenie, upraszczanie i refaktoryzacja kodu

Wypróbuj te prompty w czacie Gemini Code Assist:

  • „Czy możesz scalić IMPORTS_VARIABLES_OR_NOTE_EXPORTED_FUNCTIONS w tym pliku?”
  • „Jak uprościć funkcję FUNCTION_NAME?”
  • „Czy można połączyć FUNCTION_NAME_1 i FUNCTION_NAME_2 w jedną funkcję?”
  • „Czy możesz wstawić niektóre zmienne w FUNCTION_NAME?”
  • „Czy możesz uprościć nazewnictwo zmiennych w funkcji FUNCTION_NAME?”
Czytelność

Wypróbuj te prompty w czacie Gemini Code Assist:

  • „Zastosuj funkcję FUNCTION_NAME w jak najmniejszej liczbie wierszy kodu, jeśli to możliwe”.
  • „Dodaj komentarze do funkcji FUNCTION_NAME”.
  • „Usuń niepotrzebne spacje w funkcji FUNCTION_NAME”.
  • „Sformatuj funkcję FUNCTION_NAME w sposób podobny do reszty kodu”.
Weryfikacja kodu

Wypróbuj te prompty w czacie Gemini Code Assist:

  • „Podziel kod na części i wyjaśnij każdą z nich, korzystając z naszego kodu źródłowego”.
  • „Czy są jakieś zmienne lub słowa kluczowe, które można skrócić i uczynić bardziej zrozumiałe?”
  • „Czy możesz podać mi przydatny kod z kontekstu REPOSITORY_NAME_PACKAGE_MODULE dla tego kodu?”
  • „Co sądzisz o funkcji FUNCTION_NAME?”
Debugowanie

Wypróbuj te prompty w czacie Gemini Code Assist:

  • „Podczas próby wykonania czynności X lub dodania Y pojawia się błąd. Dlaczego?
  • „Czy widzisz błąd w funkcji FUNCTION_NAME?”
  • „Jak poprawić funkcję FUNCTION_NAME, biorąc pod uwagę ten komunikat o błędzie?”
Nauka i wprowadzenie

Wypróbuj te prompty w czacie Gemini Code Assist:

  • „Podziel ten kod na części i wyjaśnij każdą z nich, korzystając z naszego kodu źródłowego”.
  • „Pokaż, jak wywołać funkcję FUNCTION_NAME”.
  • „Jak uruchomić główną funkcję w środowisku ENVIRONMENT_NAME?”
  • „Jakie kluczowe ulepszenie techniczne możemy wprowadzić, aby zwiększyć wydajność tego kodu?”
  • „Pokaż mi implementację funkcji FUNCTION_OR_CLASS_NAME, aby uzyskać lepsze wyniki. Dodaj opis tego elementu” – na przykład: „Pokaż mi implementację funkcji foo, gdzie foo to nazwa funkcji”.
Migracja

Wypróbuj te prompty w czacie Gemini Code Assist:

  • „Podaj mi strategię, jak mogę przenieśćFILE_NAME zLANGUAGE_1 doLANGUAGE_2” – na przykład z Go do Pythona.
  • „Given the function FUNCTION_NAME in repository REPOSITORY_NAME, find me an equivalent function in language LANGUAGE_NAME that I can use."

Wypróbuj ten przepływ pracy dotyczący przetwarzania na podstawie czatu lub generowania kodu za pomocą promptów:

  1. „Weź kod FILENAME_COMPONENT napisany w języku LANGUAGE_1, przerzuć go i przekształć, a następnie przenieś do LANGUAGE_2” – na przykład z Go do Pythona.
  2. Po przeniesieniu kodu wykonaj te czynności:
    • Wybierz mniejsze kawałki i użyj /fix, aby ustawić je w pożądanym stanie.
    • Wypróbuj te prompty:
      • „Czy można coś poprawić?”
      • „Podaj możliwe problemy”.
      • „Jak przetestujesz ten kod, jeśli ta migracja jest prawidłowa?”
Generowanie dokumentacji

Wypróbuj te prompty w czacie Gemini Code Assist:

  • „Podsumuj kod w pakiecie lub folderze X i prześlij dokumentację 5 najważniejszych metod”.
  • „Wygeneruj dokumentację dla FUNCTION_OR_CLASS_NAME”.
  • „Skrócenie dokumentacji przy zachowaniu kluczowych informacji”.
Generowanie testów jednostkowych

Wypróbuj te prompty w czacie Gemini Code Assist:

  • „Generuj testy jednostkowe dla FILENAME”.
  • „Dodaj najbardziej odpowiednie przypadki testowe dla funkcji FUNCTION_NAME”.
  • „Usuń przypadki testowe, które Twoim zdaniem nie przynoszą dużej wartości”.

Sprawdzone metody

  • Używaj odpowiednich nazw zmiennych i funkcji lub fragmentów kodu. Pomoże Ci to dostosować kod do najbardziej odpowiednich przykładów kodu.
  • Używaj repozytoriów indeksów, które chcesz skalować, i unikaj dodawania przestarzałych funkcji. Dostosowywanie kodu ułatwia skalowanie stylu kodu, wzorów, semantyki kodu, wiedzy i wdrożeń w całej bazie kodu. Złe przykłady repozytoriów do skalowania to wycofane funkcje, wygenerowany kod i starsze implementacje.
  • W przypadku przypadków użycia związanych z pobieraniem kodu użyj funkcji generowania kodu zamiast funkcji uzupełniania kodu. Prompt using language such as "Using the definition of FUNCTION_NAME, generate the exact same function," or "Generate the exact implementation of FUNCTION_NAME."
  • Upewnij się, że w pliku z kodem, który chcesz pobrać, znajdują się pliki dołączone lub zaimportowane, aby zwiększyć świadomość kontekstową Gemini.
  • Dla każdego prompta wykonuj tylko 1 działanie. Jeśli np. chcesz pobrać kod i zastosować go w nowej funkcji, wykonaj te czynności w ramach 2 wytycznych.
  • W przypadkach, gdy potrzebujesz czegoś więcej niż tylko kodu (np. wyjaśnienia kodu, planu migracji lub wyjaśnienia błędu), użyj funkcji dostosowywania kodu do czatu, w której możesz rozmawiać z Gemini w kontekście kodu źródłowego.
  • Pamiętaj, że generowanie modeli AI nie jest procesem deterministycznym. Jeśli nie jesteś zadowolony/a z otrzymanej odpowiedzi, ponowne użycie tego samego prompta może przynieść lepszy wynik.
  • Pamiętaj, że generowanie testów jednostkowych działa lepiej, jeśli otworzysz plik lokalnie, a potem na czacie poprosisz o wygenerowanie testów jednostkowych dla tego pliku lub konkretnej funkcji.