Edytor skryptów

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Edytor skryptów w Studio jest głównym narzędziem do pisania skryptów na Roblox.Jest to środowisko samodoskonalające, które może pomóc ci pisać kod o wysokim wpływie, skrócić czas rozwoju i powtarzać twoje doświadczenia.Może poprawić twoje doświadczenia z pisania skryptów poprzez:

Edytor skryptów wspiera wszystkie rodzaje skryptów i otwiera automatycznie, gdy tworzysz nowy skrypt lub klikniesz dwukrotnie istniejący skrypt w oknie Eksploratora.

Funkcje automatycznego uzupełniania

Funkcje automatycznego uzupełniania edytora skryptów generują informacje związane z kodem, które mogą poprawić wydajność programowania, takie jak:

  • Informowane sugestie na temat sposobu ukończenia fraz, gdy je wpisujesz, które są kontekstowe dla modelu danych doświadczenia .Na przykład, jeśli masz Model w Workspace nazywane RocketShip , autouzupełnienie sugeruje RocketShip , gdy wpiszesz workspace.roc i wskazuje, że jest to Model .

    Autocomplete showing suggestions based on the experience's data model
  • Autofill nazwy dla zmiennych i funkcji, które deklarować, pomagając uniknąć irytujących błędów ortograficznych.

    Autocomplete showing suggestions based on a previously declared variable.
  • Popupy dokumentacji z próbkami kodu , które są podobne do tych na referencji API silnika, dając kontekst na temat wykorzystania API.

    Autocomplete showing suggestions based on a Roblox Engine API.
  • Wskazówki narzędzi na czasie przewijania , które możesz dostosować za pomocą własnej zdefiniowanej dokumentacji.

    Autocomplete showing custom documentation.
  • Diagnostyka analizy skryptów podczas przewijania z informacjami, których możesz użyć do rozwiązywania problemów.

    Autocomplete showing diagnostic information.
  • Podpisy funkcji , gdy wpiszesz argument, dostarczając odniesienie do jego parametrów i wartości zwrotnych.

    Autocomplete showing function signature

Nawigacja kodu

Idź do deklaracji

Możesz przejść do deklaracji funkcji lub zmiennej, trzymając Ctrl na Windows lub na Mac, gdy klikniesz wezwanie, lub klikając prawym przyciskiem myszy jego wezwanie i klikając Idź do deklaracji .

Go to Declaration workflow on a declared function

filtrfunkcji skryptu

Funkcja filtra Skryptu wyświetla listę wszystkich funkcji deklarowanych w skrypcie.Aby go otworzyć, naciśnij AltF na Windows lub F na Mac.Gdy lista jest otwarta, możesz przeglądać podpisy dla każdej funkcji, przeszukiwać je według nazwy i dwukrotnie kliknąć jeden, aby przejść do jego deklaracji.

Script Function Filter showing all functions inside a script

Znajdź i zastąp

Wtyczka Szukaj/Zastąp pozwala ci znaleźć i zastąpić kod w otwartym skrypcie.Widget wspiera dopasowanie przypadku, dopasowanie całego słowa i wyszukiwanie za pomocą wyrażeń regularnych.Aby go otworzyć, naciśnij CtrlF na Windows lub F na Mac.

Find/Replace widget labeled

opiniew czasie rzeczywistym

Analiza skryptów

Okno Analizy skryptów , dostępne z zakładki Widok, wykonuje analizę statyczną na swoich skryptach i wyświetla aktywne błędy i ostrzeżenia.Aby uzyskać więcej informacji o błędach i ostrzeżeniach, zobacz dokumentację Luau linting.

Script with various marked errors
Błędy skryptu podkreślone w edytorze skryptów
Script Analysis window with details on marked errors from script
Błędy wyjaśnione w oknie analizy skryptów

Wyjście

Okno Wyjście , dostępne z zakładki Widok, wyświetla błędy zarejestrowane podczas uruchamiania skryptów, wiadomości z Roblox Engine, wiadomości z wezwań do print() oraz błędy z wezwań do warn().Aby uzyskać szczegóły dotyczące konfiguracji go do swojego przepływu pracy, zobacz Wyjście.

Asysta kodowa

Asysta kodowa to funkcja, która sugeruje linie lub funkcje kodu, gdy piszesz, pomagając ci kodować bardziej wydajnie i pozostać skoncentrowanym.W oparciu o konteksty z komentarza i kodu, sugestie zostaną uruchomione na dwa sposoby:

  • Automatycznie , gdy zatrzymujesz się na linii przez kilka sekund, a model AI ma wystarczająco dużo kontekstu dla sugestii.
  • Ręcznie z skrótem na Windowsie lub na Macu (możesz dostosować ten skrót)).

Naciśnij Tab, aby zaakceptować sugestię, lub zignoruj ją, kontynuując wpisywać.Obecnie twój skrypt musi zawierać co najmniej kilka linii kodu, aby uruchomić sugestię.

Popraw sugestie

Aby uzyskać bardziej dokładne i odpowiednie sugestie, zaleca się, aby przestrzegałeś czystych praktyk kodowania, niezależnie od pomocy, i:

  • Rozbij kod na mniejsze funkcje.
  • Użyj nazw skryptów opisowych, które określają ogólną intencję tego, co każdy skrypt robi.Na przykład nazwij skrypt SyncCustomSounds zamiast po prostu Dźwięki .
  • Nadaj nazwy opisowe dla parametrów, funkcji i skryptów.Na przykład nazwij część Zielona Kula zamiast po prostu grs lub nazwij funkcję generateSphere() zamiast gen().Wykorzystanie nazwanych funkcji w stosunku do funkcji anonimowych może również produkować lepsze wskazówki.
  • Konsekwentnie włącz dobrze napisane komentarze, które opisują zadanie, które wdrażasz, i jakie powinny być wejścia/wyjścia.
    • Rozważ uwzględnienie niektórych próbnych wezwań z oczekiwanymi wynikami w komentarzach.
    • Zasugeruj, jak rozwiązać problem, na przykład -- Use raycast .
    • Użyj dokładnej funkcji lub nazwy zmiennej, którą określiłeś, na przykład -- Create 10 greenSphere objects zamiast -- Create 10 spheres.
  • Jeśli jesteś początkującym programistą, zacznij od podstawowych projektów, takich jak "spraw, aby gracz skoczył, gdy dotknie części" lub wykorzystaj narzędzie do generowania małych kodów snippetów, które możesz rozszerzać w miarę wzrostu wiedzy.

Ograniczenia

Narzędzie pomaga zautomatyzować podstawowe zadania kodowania, ale nie zawsze sugeruje doskonały kod. Znane ograniczenia obejmują:

  • Manualne uruchamianie nie zawsze generuje sugestię.
  • Sugestie są uczenione maszynowo z korpusem kodu i mogą więc odzwierciedlać niektóre ograniczenia kodu, na którym są szkoleni.Na przykład sugestie mogą nie używać nowszych interfejsów programistycznych na korzyść starszych interfejsów programistycznych lub mogą używać Lua zamiast Luau.
  • Narzędzie może generować nieprawidłowe lub mylące informacje, które nie są przydatne do twojego celu.
  • Wewnętrzne filtry próbują blokować język obraźliwy, ale nie są wszechstronne i istnieje możliwość, że narzędzie może generować obraźliwe lub uprzedzające informacje.
  • Sugestie mogą być takie same, podobne lub różne między użytkownikami, nawet z tymi samymi monitami. Twój kod jednak nigdy nie zostanie udostępniony innym.
  • Sugestia może być niekompletna ze względu na ograniczoną długość wyników z modeli uczenia się.
  • Istnieje dzienny limit liczby sugestii i po osiągnięciu limitu nie otrzymasz żadnych sugestii do następnego dnia.

prywatność, poufnośćkodu

Obecnie Roblox nie wykorzystuje żadnych niepublicznych danych do trenowania modeli uczenia się.Narzędzie wykorzystuje tylko niewielki podzbiór zasobów z wolnego rynku do dostosowywania dużych modeli językowych, a podzbiór przeszedł różne kontrole jakości i filtry bezpieczeństwa.

Ponadto wszystkie sugestie są generowane przez model AI i nie są przenoszone z jednego użytkownika na drugiego.Ponieważ twój kod nie jest wykorzystywany do szkolenia modeli, nie zostanie zasugerowany innym użytkownikom Pomocy przy kodowaniu , z jednym wyjątkiem publikowania kodu na wolnym rynku.

Wielokurkowy

Edytor skryptów wspiera użycie wielu kursoresów, aby dokonywać edycji jednocześnie.Możesz dodać kursorzy w oparciu o swoje potrzeby za pomocą kliknięcia myszki lub skrótu klawiszowego.Początkowy kurser nazywa się podstawowym kursem i dodatkowe kurory nazywane są dodatkowymi kurorami .

  • Edytuje, które wykonujesz na kopii głównego kurora do kursorów drugorzędnych.Każda edycja liczy się jako jedna akcji, więc odwołanie/przywrócenie edycji obejmuje wszystkie kurory.
  • Widgety takie jak autouzupełnianie pojawiają się na głównym kursoresie, ale nie na drugorzędnych kursoirach.
  • Wszystkie standardowe skróty klawiszowe do edycji skryptów działają z wieloma edytorami kursoresów, w tym indeksowaniem kodu, przełączaniem komentarzy i usuwaniem linii.

Poniższa tabela podsumowuje wielokrotne przepływy pracy i ich skróty.

PolecenieOknaMaków
Dodaj/usuń kurzor w lokalizacji myszy Alt + klikać + klikać
Usuń najnowszy dodany kurser CtrlUU
Dodaj/zmodyfikuj kurzor podczas przeciągania myszy Alt + przeciąganie + przeciąganie
Dodaj kursor powyżej/poniżej CtrlAlt  / CtrlAlt  /
Dodaj kursor do następnego pasującego wyboru CtrlDD
Dodaj kursor do każdego pasującego wyboru ShiftAltLShiftL
Wybór wybierać ShiftAlt + przeciąganieShift + przeciąganie
Rozdziel wybory na linie ShiftAltIShiftI

Dodaj kursorów

Możesz dodać kursor za pomocą kombinacji skrótów klawiszowych i manewrów myszy.Kursory łączą się, jeśli zajmują tę samą przestrzeń, na przykład, jeśli dodasz kursory za pomocą klawiszy strzałek lub usuniesz wszystkie znaki między kursorami.

W lokalizacji myszy

Aby dodać kurzor w lokalizacji wskazania myszy:

  1. Przytrzymaj Alt na Windowsie lub na Macu.

  2. Kliknij tam, gdzie chcesz dodać kursor.

Z przeciąganiem myszy

Możesz przeciągnąć mysz, aby dodać kurser do wyboru, podzielić wieloliniowy wybór na linie lub wybrać kolumny i bloki kodu/próżni.

Aby dodać kursor do wyboru kodu poprzez przeciąganie:

  1. Przytrzymaj Alt na Windowsie lub na Macu.

  2. Kliknij i przeciągnij mysz nad wyborem kodu.

Powyżej i poniżej podstawowego kurora

Aby dodać kurzor bezpośrednio powyżej lub poniżej głównego kurora:

  1. Naciśnij i przytrzymaj CtrlAlt na Windowsie lub na Macu.

  2. Naciśnij strzałki lub .

Do dopasowywania wyborów

Możesz dodać kursorzy do wszystkich meczów selekcji lub do następnego/poprzedniego dopasowywać, a opcjonalnie przełączyć, czy mecze są wrażliwe na dużą/małą literę lub pasują do całego słowa.

Aby dodać kursor do wszystkich meczów wybranej części:

  1. Wybierz kod, który chcesz wyszukać dopasowania.

  2. Naciśnij na Windowsie lub na Macu.

Usuń kursorów

Możesz usunąć kursor za pomocą następujących skrótów klawiszowych i manewrów myszy.Alternatywnie możesz wyjść z edycji wielokrotnego kurora, naciskając Esc.

W lokalizacji myszy

Aby usunąć kurzor:

  1. Naciśnij i przytrzymaj Alt na Windows lub na Mac.

  2. Kliknij kursor, który chcesz usuwać, wyjmować.

Najnowsze dodane

Aby usunąć najnowszy dodany kurser, naciśnij CtrlU na Windowsie lub U na Macu.

Kopiuj i wklej kursory

Kopiowanie wyboru kodu obejmuje kursoры w nim.Zachowanie pasty zależy od liczby kursoresów na źródle i liczby kursoresów na docelowej stronie:

  • Jeśli liczba kursoров jest taka sama, każdy skopiowany kurser wkleja do odpowiedniego kurora docelowego.
  • Jeśli liczba kursoirów jest różna, każdy kursoir w docelu otrzymuje całą pastę z każdym skopiowanym kursorem jako nową linię.

Formatowanie na typie

Naciśnięcie Enter/Return automatycznie zidentyfikuje każdy kurser na nowej linii w stosunku do poprzedniej linii.Jeśli poprzednia linia zaczyna się od niekompletnego bloku, formatowacz spróbuje ją uzupełnić.

Ustawienia edytora

Wiele opcji personalizacji jest dostępnych za pośrednictwem plikuUstawienia Studio ( AltS na Windows; S na Mac).

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

Powszechnie modyfikowane opcje obejmują:

OpcjaOpis
Czcionka Czcionka i rozmiar dla kodu w edytorze.
Szerokość zakładki Liczba miejsc reprezentujących identyfikator Tab odstępu.
Zaznaczanie za pomocą spacji Jeśli włączone, spacje równe szerokości zakładki są wstawiane za pomocą Tab naciskać.
Owijanie tekstu Jeśli włączone, dłuższe linie kodu obejmują następną linię.
Przedstawienie kolorów edytora skryptów Ustawienie koloru dla elementów kodu, kolory wyboru i więcej.Po wybraniu ustawienia możesz ustawić konkretne kolory dla opcji takich jak Kolor wyboru i Kolor komentarza .

Skróty klawiszowe

Edytor skryptów ma następujące skróty klawiszowe.Możesz również uzyskać dostęp do wielu poleceń z zakładki Skrypt, która pojawia się w pasku narzędzi Studio za każdym razem, gdy oglądasz lub edytujesz skrypt.

PolecenieOknaMaków
Zamknij skrypt CtrlWW
Otwórz ponownie ostatni zamknięty skrypt CtrlShiftTShiftT
Szybkie otwarcie CtrlPP
Pokaż skrypt w Explorerze CtrlAltKK
Przybliż Ctrl==
Wyłącz zoom Ctrl--
Zresetuj zoom skryptu Ctrl00