Editor del Script

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Il Editor Script in Studio è lo strumento principale per lo scripting su Roblox. È un ambiente self-improving che può aiutarti a scrivere codice ad alta impatto, ridurre il tuo tempo di sviluppo e itérare le tue esperienze. Può migliorare la tua esperienza di scripting con:

Lo Script Editor supporta tutti i tipi di script e si apre automaticamente quando crei uno script nuovo o fai doppio clic su uno script esistente nella finestra Explorer .

Caratteristiche di completamento automatico

Le funzionalità di completamento automatico dello script generano informazioni correlate al codice che possono migliorare la tua efficienza di 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 Class.Model in Model chiamato 0> R

    Autocomplete showing suggestions based on the experience's data model
  • Riempi automaticamente i nomi per le variabili e le funzioni che dichiari, aiutandoti a evitare pesanti errori di digresso.

    Autocomplete showing suggestions based on a previously declared variable.
  • Popup di documentazione con campioni di codice che sono simili a quelli sull'Engine API , dandoti contesto sull'uso dell'API.

    Autocomplete showing suggestions based on a Roblox engine API.
  • suggerimenti sullo strumento in tempo reale che puoi personalizzare con la tua documentazione definita.

    Autocomplete showing custom documentation.
  • Diagnosi dello script dell'on-хоover con informazioni che puoi utilizzare per risolvere gli errori.

    Autocomplete showing diagnostic information.
  • Firme funzionali quando digiti un argomento, fornendo un riferimento per i suoi parametri e i suoi valori di ritorno.

    Autocomplete showing function signature

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 chiamata e facendo clic su Vai alla dichiarazione .

Go to Declaration workflow on a declared function

Filter Funzione Script

Il Script Function Filter mostra un elenco di tutte le funzioni dichiarate in uno script. Per aprirlo, premi AltF su Windows o 2> ⌥2> 5> F5> su Mac. Con l'elenco aperto, puoi sfogliare le firme per ciascuna funzione, filtrare attraverso di esse in base al nome e fare doppio clic

Script Function Filter showing all functions inside a script

Trova e sostituisci

Il widget Trova/Sostituisci ti consente di trovare e sostituire il codice in uno script aperto. Il widget supporta la corrispondenza della parola, la corrispondenza della parola intera e la ricerca con regole regolari. Per aprirlo, premi CtrlF su Windows o 2>⌘2> su Mac.

Find/Replace widget labeled

Feedback in tempo reale

Analisi dello script

La Script Analysis finestra, accessibile dalla Visualizza scheda, esegue l'analisi statica sui tuoi script e visualizza gli errori e le avvertenze attivi. Per ulteriori informazioni sugli errori e sugli avvertimenti, vedi la Luau linting documentazione.

Script with various marked errors
Script errori sottolineati nell'editor script
Script Analysis window with details on marked errors from script
Errori spiegati nella finestra di analisi del script

Finestra di uscita

La finestra di uscita, accessibile dalla Visualizza scheda, mostra gli errori catturati dall'esecuzione degli script, i messaggi dal motore Roblox e i messaggi dal chiamata a print() . Per i dettagli sulla configurazione per il tuo flusso di lavoro, vedi 2>finestra di uscita2> .

Assistente del Codice

Assistente del Codice è una funzione che suggerisce righe o funzioni del codice mentre digiti, aiutandoti a inserisci / scriviin modo più efficiente e rimanere concentrato. In base ai contesti dal tuo commento e dal tuo codice, le suggerenze verranno attivate in due modi:

  • Automaticamente quando fai una pausa su una linea per pochi secondi e il modello AI ha abbastanza contesto per una raccomandazione.
  • Manualmente con scorciatoia Alt su Windows o 1>∖1> su Mac (puoi 4>Personalizzare 4> questo Scorciatoia).

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

Miglioramento delle suggerimenti

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

  • Rompere il tuo codice in funzioni più piccole.
  • Usa nomi di script descrittivi che catturano l'intenzione generale di cosa faccia ogni script. Ad esempio, nomea uno script SincronizzaSuoniCustomi invece di Suoni .
  • Assegna nomi descrittivi per i parametri, le funzioni e gli script. Ad esempio, nome a parte GreenSphere invece di semplicemente grs , o nome a funzione generateSphere() invece di 1> gen() . L'uso di funzioni nominate può anche produrre migliori suggerimenti.
  • Includi coerentemente 评论 ben scritti che descrivono il compito che stai implementando e quali sono gli input / uscite.
    • Considera di includere alcune chiamate di esempio con risultati previsti nei commenti.
    • Suggerire come risolvere un problema, per esempio -- Use raycast .
    • Usa il nome esatto della funzione o variabile che hai definito, ad esempio -- Create 10 greenSphere objects invece di -- Create 10 spheres .
  • Se sei uno scriptatore di novizio, inizia con progetti di base come "fai saltare il giocatore quando tocca la parte" o usa lo strumento per generare piccoli frammenti di codice che puoi espandere man mano che conosci di più.

Limitazioni

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

  • Il triggering automatico non sempre genera una suggerimento.
  • Le suggerenze sono imparate automaticamente da un corso di codice e possono quindi riflettere alcune limitazioni del codice su cui sono addestrati. Ad esempio, le suggerenze potrebbero non utilizzare API più recenti in favore di API più vecchie, o potrebbero utilizzare Lua invece di Luau .
  • Lo strumento può generare informazioni errate o ingannevoli che non sono utili per il tuo scopo.
  • I filtri interni tentano di bloccare la lingua offensiva, ma non sono tutti completi e c'è una possibilità che lo strumento possa generare informazioni offensive o pregiudizievoli.
  • Le raccomandazioni 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 proposta potrebbe essere incompleta a causa della limitata lunghezza di uscita dei modelli di apprendimento.
  • C'è un limite giornaliero per il numero di suggerimenti e, una volta raggiunto il limite, non riceverai suggerimenti fino al prossimo giorno.

Privacy del codice

Attualmente, Roblox non utilizza alcun dato non pubblico per allenare i modelli di apprendimento. Lo strumento utilizza solo un piccolo insieme di risorse del mercato libero per il calibraggio di grandi modelli di lingua e lo strumento ha superato varie convalide per i filtri di qualità e sicurezza.

Inoltre, tutte le raccomandazioni vengono generate dal modello AI e non vengono trasferite 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'unica eccezione del codice che viene pubblicato negli oggetti del mercato libero.

Multi-Cursor

Lo script editor supporta l'uso di più cursori per apportare modifiche contemporaneamente. Puoi aggiungere cursori in base alle tue esigenze con un clic del mouse o una Scorciatoiadi tastiera. Il cursore iniziale è chiamato il cursore principale e i cursori aggiuntivi sono chiamati cursore secondari .

  • Modifica che fai alla copia principale del cursore al cursore secondario. Ogni modifica conta come un'azione, quindi annullare/ripetere una modifica si applica a tutti i cursori.
  • I widget come autocompletamento appaiono sul cursore principale ma non sui cursori secondari.
  • Tutti gli standard scorciatoie da tastiera per il lavoro di modifica dello script con multi-Cursor editing, inclusa l'indentazione del codice, attivazione dei commenti e la cancellazione delle righe.

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

ComandoWindowsMac
Aggiungi/Rimuovi Cursor alla posizione del mouse Alt + clicca + clicca
Rimuovi il cursore aggiunto di recente. CtrlUU
Aggiungi/Modifica Cursor on Mouse Drag Alt + trascina + trascina
Aggiungi Cursor Above / Below Ctrl Alt / Ctrl 0> Alt0> 2> ↓2> 0>⌥0> 2>↓2>
Aggiungi Cursor alla prossima selezione di matchmaking CtrlDD
Aggiungi Cursor a ogni selezione corrispondente ShiftAltLSpostamento della barra spaziatriceL
Selezione della colonna/blocco ShiftAlt  + trascinamentoShift + trascinamento
Dividi le selezioni in linee ShiftAltISpostamento della tastieraI

Aggiungere 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 frecce o elimini tutti i personaggi tra i cursori.

Alla posizione del mouse

Per aggiungere un cursore alla posizione del mouse:

  1. Tenere premuto Alt su Windows o su Mac.

  2. Fai clic dove vuoi aggiungere il cursor.

Con il trascinamento del mouse

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

Per aggiungere un cursore a una selezione di codice attraverso il trascinamento:

  1. Tenere 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 cursor direttamente sopra o sotto il cursor principale:

  1. Premi e premi CtrlAlt su Windows o su Mac.

  2. Premi le frecce o .

Per la corrispondenza delle selezioni

Puoi aggiungere cursori a tutte le partite di una selezione o alla prossima/precedente Corrisponde, e opzionalmente attivare/disattivare se le partite sono sensibili alle maiuscole e/o se le parole corrispondono intere parole.

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

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

  2. Premi ShiftAltL su Windows o Shift1> ⌥1> 3> L 3> su Mac.

Rimozione dei cursori

Puoi rimuovere i cursori con i seguenti scorciatoie da tastiera e manovre del mouse. In alternativa, puoi uscire dall'editing multi-Cursor facendo clic su Esc .

Alla posizione del mouse

Per rimuovere un cursore:

  1. Premi e premi Alt su Windows o su Mac.

  2. Fai clic sul cursor che vuoi Rimuovere.

Più di recente aggiunto

Per rimuovere il cursore più recentemente aggiunto, premi CtrlU su Windows o 0>U0> su Mac.

Copia e pasta i cursori

La copia di un'azione 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, allora ogni cursore copiato pasta in ogni corrispondente cursore di destinazione.
  • Se il numero di cursori è diverso, allora ogni cursore nella destinazione riceve l'intera pasta con ogni cursore copiato come nuestra linea.

Formattazione di tipo on-type

L'auto-incremento di ogni cursore rispetto alla nuova linea in cui si trova la linea precedente. Se la linea precedente inizia con un blocco incompleto, il formatterà cercherà di completarlo.

Impostazioni dell'editor

Molte opzioni di personalizzazione sono accessibili tramite File > Impostazioni dello studio ( Alt 0> S0> su Windows; 3>⌥3> 5>S5> su Mac).

A close up view of the Studio Settings window with the Script Editor tab selected.

Le opzioni comunemente modificati includono:

OpzioneDescrizione
Carattere Faccia e dimensione del carattere per il codice nell'editor.
Larghezza della scheda Numero di spazi che rappresentano un'Tabella spaziatura.
Indentazione usando gli spazi Se abilitato, gli spazi pari a Larghezza della scheda vengono inseriti con Tab Stampare.
Avvolgimento del testo Se abilitato, le righe di codice più lunghe vengono avvolte nella prossima riga.
Impostazione predefinita dello script editor Color preset per elementi di codice, colori di selezione e altro ancora. Dopo aver scelto un preset, puoi impostare colori specifici per opzioni come Colore di selezione e Colore di commento .

Scorciatoie da tastiera

Lo script editor ha i seguenti scorciatoie da tastiera. Puoi anche accedere a molti comandi dalla scheda script che appare nella barra degli strumenti di Studio ogni volta che stai visualizzando o modificando uno script.

ComandoWindowsMac
Chiudi script CtrlWW
Riapri lo script chiuso l'ultima volta CtrlShiftTSpazioT
Apertura rapida CtrlPP
Mostra script nell'esploratore delle script. CtrlAltKK
Zoom in. Ctrl==
Zoom fuori Ctrl--
Ripristina lo script zoom Ctrl00