Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzare la personalizzazione del codice di Gemini Code Assist

Questo documento descrive come utilizzare la personalizzazione del codice di Gemini Code Assist e fornisce alcune best practice. Questa funzionalità ti consente di ricevere suggerimenti sul codice che si basano sulle librerie interne, sulle API private e sullo stile di programmazione della tua organizzazione.

Prima di iniziare

Come utilizzare la personalizzazione del codice

La tabella seguente elenca i modi per utilizzare la personalizzazione del codice di Gemini Code Assist:

Modulo	Come attivare	Note e risorse
Chat in linguaggio naturale	Inserisci un prompt in linguaggio naturale nella chat di Gemini Code Assist nell'IDE.	Considera quanto segue: La cronologia chat non è disponibile. Evita le query in più passaggi. Puoi chiedere maggiori dettagli sulle fonti, inclusi i link alle fonti specifiche. Se evidenzi o selezioni il codice quando invii un messaggio nella chat, Gemini Code Assist utilizza questo codice per migliorare la personalizzazione del codice e la qualità della chat. Per saperne di più, vedi Chattare con Gemini Code Assist .
Genera codice	Nella barra di selezione rapida dell'IDE, con o senza codice selezionato, premi `Command+Invio` (su macOS) o `Ctrl+Invio`.	Per ulteriori informazioni, consulta Generare codice con i prompt.
Trasforma codice	Nella barra di selezione rapida dell'IDE, con o senza codice selezionato, inserisci `/fix`.	Per ulteriori informazioni, consulta Generare codice con i prompt.
Completamento automatico	La personalizzazione del codice viene attivata automaticamente e fornisce suggerimenti in base a ciò che scrivi.	Considera quanto segue: Il completamento del codice richiede un certo livello di confidenza per proporre un suggerimento. Assicurati che sia disponibile una quantità significativa di codice in modo che vengano recuperati gli snippet pertinenti. Il completamento del codice verifica se hai le librerie richieste per utilizzare determinati elementi della funzione. Per saperne di più, consulta Ottenere completamenti del codice.

Casi d'uso ed esempi di prompt

La tabella seguente fornisce indicazioni ed esempi sull'utilizzo della personalizzazione del codice in casi d'uso specifici:

Caso d'uso	Cose da provare
Scrittura di nuovo codice	Prova a fare quanto segue per generare codice nel tuo IDE o nella chat di Gemini Code Assist: Genera codice che utilizzi termini già menzionati nel tuo codebase. Incolla il codice, ad esempio una firma funzionale o un codice con commenti `TODO`, quindi chiedi a Gemini Code Assist di compilare o sostituire i commenti `TODO` con il codice. Aggiungi commenti con spiegazione dal contesto. Prova a generare codice con i seguenti prompt nella chat di Gemini Code Assist: "Scrivi una funzione principale in cui viene creata una connessione a `DATABASE`. Includi i controlli di integrità". "Scrivi un `FUNCTION_OR_CLASS` nella seguente struttura: `EXPLAIN_STRUCTURE`." Dopo aver generato del codice, prova a utilizzare un prompt di follow-up per migliorarlo: "Prova il comando `/fix` per modificare il codice generato, ad esempio gli errori di sintassi." "Aggiungi importazioni mancanti". "Prova `/fix` sul codice generato dalla chat."
Pulizia, semplificazione e refactoring del codice	Prova i seguenti prompt nella chat di Gemini Code Assist: "Puoi unire `IMPORTS_VARIABLES_OR_NOTE_EXPORTED_FUNCTIONS` in questo file?" "Come semplificheresti la funzione `FUNCTION_NAME`?" "Puoi unire `FUNCTION_NAME_1` e `FUNCTION_NAME_2` in un'unica funzione?" "Potresti incorporare alcune variabili in `FUNCTION_NAME`?" "Potresti semplificare la denominazione delle variabili nella funzione `FUNCTION_NAME`?"
Leggibilità	Prova i seguenti prompt nella chat di Gemini Code Assist: "Scrivi la funzione `FUNCTION_NAME` in meno righe di codice, se possibile." "Aggiungi commenti alla funzione `FUNCTION_NAME`." "Rimuovi gli spazi bianchi non necessari nella funzione `FUNCTION_NAME`." "Formatta la funzione `FUNCTION_NAME` in modo simile al resto del codice."
Revisione del codice	Prova i seguenti prompt nella chat di Gemini Code Assist: "Dividi il codice in parti e spiega ogni parte utilizzando il nostro codebase". "Esistono variabili o parole chiave che potrebbero essere più brevi e più autoesplicative?" "Puoi darmi un codice utile dal contesto `REPOSITORY_NAME_PACKAGE_MODULE` per questo codice?" "Cosa pensi della funzione `FUNCTION_NAME`?"
Debug	Prova i seguenti prompt nella chat di Gemini Code Assist: "Ricevo un errore quando provo a eseguire X/aggiungere Y. Perché?" "Riesci a individuare un errore nella funzione `FUNCTION_NAME`?" "Come risolveresti il problema della funzione `FUNCTION_NAME` dato questo messaggio di errore?"
Apprendimento e onboarding	Prova i seguenti prompt nella chat di Gemini Code Assist: "Dividi questo codice in parti e spiega ciascuna di esse utilizzando il nostro codebase." "Mostra come chiamare la funzione `FUNCTION_NAME`?" "Mostra come eseguire la funzione principale nell'ambiente `ENVIRONMENT_NAME`?" "Qual è il miglioramento tecnico chiave che possiamo apportare per rendere questo codice più efficiente?" "Mostrami l'implementazione di `FUNCTION_OR_CLASS_NAME` per ottenere risultati migliori e aggiungi cos'è questo elemento specifico", ad esempio, "Mostrami l'implementazione della funzione foo, dove foo è il nome della funzione".
Migrazione	Prova i seguenti prompt nella chat di Gemini Code Assist: "Dammi una strategia per eseguire la migrazione di `FILE_NAME` da `LANGUAGE_1` a `LANGUAGE_2`", ad esempio da Go a Python. "Data la funzione `FUNCTION_NAME` nel repository `REPOSITORY_NAME`, trova una funzione equivalente nel linguaggio `LANGUAGE_NAME` che posso utilizzare." Prova il seguente flusso di lavoro di trasformazione basato sulla chat o sulla generazione di codice utilizzando i prompt: "Prendi il codice `FILENAME_COMPONENT` già scritto in `LANGUAGE_1` e refactor e migralo a `LANGUAGE_2`", ad esempio, da Go a Python. Dopo aver eseguito la migrazione di parte del codice, prova a effettuare le seguenti operazioni: Seleziona blocchi più piccoli e utilizza `/fix` per portarli allo stato che desideri. Prova i seguenti prompt: "C'è qualcosa che si può migliorare?" "Dammi possibili punti deboli." "Come testeresti questo codice se la migrazione è corretta?"
Generazione della documentazione in corso…	Prova i seguenti prompt nella chat di Gemini Code Assist: "Riassumi il codice nel pacchetto o nella cartella `X` e fornisci la documentazione per i primi cinque metodi importanti." "Genera la documentazione per `FUNCTION_OR_CLASS_NAME`." "Abbrevia la documentazione mantenendo le informazioni chiave."
Generazione di test delle unità	Prova i seguenti prompt nella chat di Gemini Code Assist: "Genera test unitari per `FILENAME`." "Aggiungi gli scenari di test più pertinenti per la funzione `FUNCTION_NAME`." "Rimuovi gli scenari di test che ritieni non apportino molto valore."

Best practice

Utilizza nomi di variabili e funzioni o snippet di codice pertinenti. Questa guida alla personalizzazione del codice ti indirizza verso gli esempi di codice più pertinenti.
Utilizza i repository di indici che vuoi scalare ed evita di aggiungere funzionalità ritirate. La personalizzazione del codice consente di scalare lo stile del codice, i pattern, la semantica, le conoscenze e le implementazioni del codice in tutto il codebase. Esempi negativi di repository da scalare sono funzionalità ritirate, codice generato e implementazioni legacy.
Per i casi d'uso di recupero del codice, utilizza la funzionalità di generazione del codice anziché il completamento del codice. Prompt che utilizzano un linguaggio come "Utilizzando la definizione di FUNCTION_NAME, genera la stessa funzione" o "Genera l'implementazione esatta di FUNCTION_NAME".
Avere include o importazioni presenti nel file per il codice che vuoi recuperare per migliorare la consapevolezza contestuale di Gemini.
Esegui una sola azione per ogni prompt. Ad esempio, se vuoi recuperare il codice e implementarlo in una nuova funzione, esegui questi passaggi in due prompt.
Per i casi d'uso in cui vuoi qualcosa di più del semplice codice (ad esempio spiegazione del codice, piano di migrazione o spiegazione dell'errore), utilizza la personalizzazione del codice per la chat, in cui puoi conversare con Gemini con la tua codebase nel contesto.
Tieni presente che la generazione di modelli di AI non è deterministica. Se non sei soddisfatto della risposta, l'esecuzione dello stesso prompt potrebbe portare a un risultato migliore.
Tieni presente che la generazione di test delle unità in genere funziona meglio se apri il file localmente e poi, dalla chat, chiedi di generare test delle unità per questo file o per una funzione specifica.