Editor di script

L'editor di script in Studio è lo strumento principale per lo scripting su Roblox.È un ambiente auto migliorante che può aiutarti a scrivere codice ad alto impatto, ridurre il tempo di sviluppo e iterare sulle tue esperienze.Può migliorare la tua esperienza di scripting di:

• Formattazione e evidenziazione della sintassi nel tuo codice.
• Offrire modi per completare automaticamente le frasi nel tuo codice mentre inserisci / scrivi.
• Aiutandoti a navigare nel codice saltando alle dichiarazioni di variabili e funzioni.
• Aiutandoti a trovare e sostituire codice in script aperti o in tutti gli script.
• Fornire feedback in tempo reale sulla qualità e sulle Prestazionedel tuo codice.

L'editor di script supporta tutti i tipi di script e si apre automaticamente quando crei un nuovo script o fai doppio clic su uno script esistente nella finestra Explorer.

Caratteristiche di completamento automatico

Le funzionalità di completamento automatico dell'editor di script generano informazioni legate al codice che possono migliorare l'efficienza della programmazione, come:

• Suggerimenti informati su come completare le frasi mentre le digiti che sono contestuali al modello di dati dell'esperienza .Ad esempio, se hai un Model in Workspace chiamato RocketShip , l'autocompletamento suggerisce RocketShip quando digiti workspace.roc e indica che è un Model .

  

  Usa le chiavi ↑ e ↓ per navigare nelle suggestioni, quindi premi Tab o Enter per accettare una suggestione e inserire la frase completa.

• Riempi automaticamente i nomi per le variabili e le funzioni che Dichiarare, aiutandoti a evitare errori fastidiosi.

  

• Popup di documentazione con esempi di codice simili a quelli sulla Referenza dell'API del motore, che ti danno contesto sull'utilizzo dell'API.

  

• On-hover tooltips che puoi personalizzare con la tua stessa documentazione definita.

  

• Diagnosi di analisi degli script in hover con informazioni che puoi utilizzare per risolvere gli errori.

  

• Firme di funzione quando digiti un argomento, fornendo un riferimento per i suoi parametri e i valori di ritorno.

  

Navigazione del codice

Vai alla dichiarazione

Puoi saltare alla dichiarazione di una funzione o variabile tenendo premuto Ctrl su Windows o ⌘ su Mac quando fai clic sulla chiamata, o facendo clic con il pulsante destro del mouse sulla sua chiamata e facendo clic su Vai alla dichiarazione .

Filtro funzione script

Il Filtro funzione script mostra una lista di tutte le funzioni dichiarate in uno script.Per aprirlo, premi AltF su Windows o ⌥F su Mac.Con l'elenco aperto, puoi navigare nelle firme per ciascuna funzione, filtrarle per nome e fare doppio clic su una per saltare alla sua dichiarazione.

Trova e sostituisci

Il widget Trova/Sostituisci ti consente di trovare e sostituire il codice in uno script aperto.Il widget supporta il caso di corrispondenza, corrisponde a tutta la parola e cerca con le espressioni regolari.Per aprirlo, premi CtrlF su Windows o ⌘F su Mac.

Riscontro/Replicain tempo reale

Analisi dello script

La finestra Analisi script , accessibile dalla scheda Vista, esegue analisi statica sui tuoi script e visualizza errori e avvertimenti attivi.Per maggiori informazioni sugli errori e gli avvertimenti, vedi la documentazione Luau linting.

Uscita

La finestra Output , accessibile dalla scheda Vista, visualizza gli errori catturati dall'esecuzione di script, messaggi da Roblox Engine, messaggi da chiamate a print() e errori da chiamate a warn() .Per i dettagli sulla configurazione per il tuo flusso di lavoro, vedi Output.

Assistenza al codice

Assistenza del codice è una funzione che suggerisce linee o funzioni di codice mentre digiti, aiutandoti a programmare in modo più efficiente e a rimanere concentrato.In base ai contesti del tuo commento e del codice, le suggestioni verranno attivate in due modi:

• Automaticamente quando fermi una linea per qualche secondo e il modello AI ha abbastanza contesto per un suggerimento.
• Manualmente con scorciatoia Alt∖ su Windows o ⌥∖ su Mac (puoi personalizzare questa Scorciatoia).

Premi Tab per accettare un suggerimento, o ignoralo continuando a inserisci / scrivi.Attualmente, il tuo script deve contenere almeno alcune righe di codice per attivare un suggerimento.

Migliora le suggestioni

Per ottenere suggerimenti più precisi e pertinenti, si consiglia di seguire le pratiche di codifica pulita, indipendentemente dall'assistenza, e:

• Dividi il tuo codice in funzioni più piccole.
• Usa nomi di script descrittivi che catturino l'intento generale di ciò che ogni script fa.Ad esempio, nomina uno script SyncCustomSounds invece di semplicemente Sounds .
• Assegna nomi descrittivi per parametri, funzioni e script.Ad esempio, nomina una parte Sfera Verde invece di semplicemente grs, o nomina una funzione invece di >.L'utilizzo di funzioni con nome versus funzioni anonime può anche produrre suggerimenti migliori.
• Consistente includere commenti ben scritti che descrivono il compito che stai implementando e quali dovrebbero essere gli input/output.

  • Considera di includere alcune chiamate di esempio con risultati attesi nei commenti.
  • Suggerisci come risolvere un problema, ad esempio -- Use raycast .
  • Usa l'esatta funzione o il nome della variabile che hai definito, ad esempio -- Create 10 greenSphere objects invece di -- Create 10 spheres.
• Se sei uno scriptatore novizio, inizia con progetti di base come "make the player jump when they touch the part" o usa lo strumento per generare piccoli snippet di codice che puoi espandere man mano che la tua conoscenza cresce.

Limitazioni

Lo strumento aiuta a automatizzare le attività di codifica di base, ma non suggerisce sempre il codice perfetto. Le limitazioni conosciute includono:

• L'attivazione manuale non genera mai sempre una suggestione.
• Le suggestioni sono apprese automaticamente da un corpus di codice e possono quindi riflettere alcune limitazioni del codice su cui sono addestrati.Ad esempio, le suggestioni potrebbero non utilizzare nuove API a favore di API più vecchie, o potrebbero utilizzare Lua invece di Luau.
• Lo strumento può generare informazioni errate o fuorvianti che non sono utili per il tuo scopo.
• I filtri interni tentano di bloccare il linguaggio offensivo, ma non sono completi e c'è la possibilità che lo strumento possa generare informazioni offensive o pregiudizievoli.
• Le suggestioni possono essere le stesse, simili o diverse tra gli utenti, anche con gli stessi prompt. Il tuo codice, tuttavia, non verrà mai condiviso con gli altri.
• La suggestione potrebbe essere incompleta a causa della limitata lunghezza dell'output dai modelli di apprendimento.
• C'è un limite giornaliero per il numero di suggerimenti e, una volta raggiunto il limite, non riceverai suggerimenti fino al giorno successivo.

Privacy del codice

Al momento, Roblox non utilizza alcun dato non pubblico per addestrare i modelli di apprendimento.Lo strumento utilizza solo una piccola sottoclasse di risorse del mercato libero per il tuning di grandi modelli linguistici e la sottoclasse è passata attraverso vari controlli per filtri di qualità e sicurezza.

Inoltre, tutti i suggerimenti sono generati da il modello AI e non vengono trasferiti da un utente all'altro.Poiché il tuo codice non viene utilizzato per l'allenamento del modello, non verrà suggerito ad altri utenti di Code Assist , con l'eccezione che il codice venga pubblicato su oggetti di mercato libero.

Multi-curatore

L'editor di script supporta l'uso di più cursori per fare modifiche simultaneamente.Puoi aggiungere cursori in base alle tue esigenze con un clic del mouse o con una Scorciatoiada tastiera.Il cursore iniziale è chiamato cursore primario e i cursori aggiuntivi sono chiamati cursori secondari .

• Modifica quelle che fai alla copia del cursore primario ai cursori secondari.Ogni modifica conta come un'azione, quindi l'annullamento/il ripristino di una modifica si applica a tutti i cursori.
• Widget come completamento automatico appaiono sul cursore primario ma non sui cursori secondari.
• Tutti gli scorciatoie standard tastiera per l'editing di script funzionano con l'editing multi-curatore, inclusa l'indentazione del codice, l'attivazione dei commenti e la cancellazione delle righe.

La seguente tabella riassume i flussi di lavoro multi-cursor e i loro scorciatoie.

Aggiungi cursori

Puoi aggiungere cursori con una combinazione di scorciatoie da tastiera e manovre del mouse.I cursori si uniscono se occupano lo stesso Spazio, come se aggiungi cursori con le freccie o elimini tutti i caratteri tra i cursori.

Alla posizione del mouse

Per aggiungere un cursore alla posizione del puntatore del mouse:

1. Tieni premuto Alt su Windows o ⌥ su Mac.

2. Fai clic dove vuoi aggiungere il cursore.

Con trascinamento del mouse

Puoi trascinare il mouse per aggiungere un cursore a una selezione, dividere una selezione multilinea in linee o selezionare colonne e blocchi di codice/spazio bianco.

Per aggiungere un cursore a una selezione di codice trascinando:

1. Tieni premuto Alt su Windows o ⌥ su Mac.

2. Fai clic e trascina il mouse sulla selezione del codice.

Sopra e sotto il cursore primario

Per aggiungere un cursore direttamente sopra o sotto il cursore primario:

1. Premi e tieni premuto CtrlAlt su Windows o ⌘⌥ su Mac.

2. Premi le frecce ↑ o ↓.

Per le selezioni corrispondenti

Puoi aggiungere cursori a tutte le partite di una selezione o alla Corrispondesuccessiva/precedente, e opzionalmente attivare se le partite sono sensibili al caso e/o corrispondono a tutta la parola.

Per aggiungere un cursore a tutte le corrispondenze di una porzione selezionata:

1. Seleziona il codice che vuoi cercare per le corrispondenze.

2. Premi ShiftAltL su Windows o Shift⌥L su Mac.

Rimuovi i cursori

Puoi rimuovere i cursori con le seguenti scorciatoie da tastiera e le manovre del mouse.In alternativa, puoi uscire dall'editing multi-curatore premendo Esc .

Alla posizione del mouse

Per rimuovere un cursore:

1. Premi e tieni premuto Alt su Windows o ⌥ su Mac.

2. Fai clic sul cursore che vuoi Rimuovere.

Più recentemente aggiunto

Per rimuovere il cursore più recentemente aggiunto, premi CtrlU su Windows o ⌘U su Mac.

Copia e pasta cursori

La copia di una selezione di codice include i cursori all'interno.Il comportamento della pasta dipende dal numero di cursori alla fonte e dal numero di cursori alla destinazione:

• Se il numero di cursori è lo stesso, poi ogni cursore copiato viene incollato a ciascun cursore di destinazione corrispondente.
• Se il numero di cursori è diverso, allora ogni cursore alla destinazione riceve l'intera pasta con ogni cursore copiato come nuova riga.

Formattazione on-type

Premere invio/ritorno indenterà automaticamente ogni cursore alla nuova linea rispetto alla linea precedente.Se la linea precedente inizia con un blocco incompleto, il formattatore cercherà di completarlo.

Impostazioni dell'editor

Molte opzioni di personalizzazione sono accessibili tramite File ⟩ Impostazioni di Studio ( AltS su Windows; ⌥S su Mac).

Le opzioni comunemente modificate includono:

Scorciatoie della tastiera

L'editor di script ha le seguenti scorciatoie da tastiera.Puoi anche accedere a molti comandi dalla scheda Script che appare nella barra degli strumenti di Studio ogni volta che visualizzi o modifichi uno script.