Trình soạn thảo kịch bản

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Trình soạn thảo tập lệnh trong Studio là công cụ chính để lập trình trên Roblox.Nó là một môi trường tự cải tiến có thể giúp bạn viết mã có tác động lớn, rút ngắn thời gian phát triển của bạn và lặp lại kinh nghiệm của bạn.Nó có thể cải thiện trải nghiệm lập trình của bạn bằng cách:

Trình soạn thảo kịch bản hỗ trợ tất cả các loại kịch bản và mở tự động khi bạn tạo một kịch bản mới hoặc nhấp đúp vào một kịch bản hiện có trong cửa sổ Explorer.

Chức năng hoàn thành tự động

Các tính năng hoàn thành tự động của Trình soạn thảo Scrip tạo ra thông tin liên quan đến mã có thể cải thiện hiệu quả lập trình của bạn, chẳng hạn như:

  • Đề xuất thông báo về cách hoàn thành các câu khi bạn gõ chúng theo cách có liên quan đến mô hình dữ liệu kinh nghiệm dữ liệu model .Ví dụ, nếu bạn có một Model trong Workspace được gọi là Tên lửa , autocomplete gợi ý RocketShip khi bạn nhập workspace.roc và chỉ ra rằng nó là một Model .

    Autocomplete showing suggestions based on the experience's data model
  • Tự động hoàn thành tên cho biến và chức năng mà bạn tuyên bố, giúp bạn tránh các lỗi chính tả khó chịu.

    Autocomplete showing suggestions based on a previously declared variable.
  • Các bảng thông báo về tài liệu với mã thử nghiệm giống như những cái trên Tham chiếu API động cơ, cho bạn ngữ cảnh về việc sử dụng API.

    Autocomplete showing suggestions based on a Roblox Engine API.
  • Thông tin chi tiết trong khi hoạt động mà bạn có thể tùy chỉnh với tài liệu được định nghĩa riêng của bạn.

    Autocomplete showing custom documentation.
  • Phân tích chẩn đoán lỗi khi hoạt động trên kịch bản với thông tin bạn có thể sử dụng để khắc phục lỗi.

    Autocomplete showing diagnostic information.
  • Chữ ký chức năng khi bạn nhập một tham số, cung cấp cho bạn một tham chiếu cho các tham số và giá trị trả về của nó.

    Autocomplete showing function signature

Điều hướng mã

Đi đến tuyên bố

Bạn có thể chuyển đến tuyên bố của một chức năng hoặc biến bằng cách giữ Ctrl trên Windows hoặc trên Mac khi nhấp vào cuộc gọi, hoặc bằng cách nhấp chuột phải vào cuộc gọi của nó và nhấp vào Đi đến tuyên bố .

Go to Declaration workflow on a declared function

Lọc chức năng kịch bản

Chức năng lọc Chức năng kịch bản hiển thị một danh sách tất cả các chức năng được tuyên bố trong một kịch bản.Để mở nó, hãy nhấn AltF trên Windows hoặc F trên Mac.Với danh sách mở, bạn có thể duyệt các chữ ký cho mỗi chức năng, lọc chúng theo tên và nhấp đúp vào một để chuyển đến tuyên bố của nó.

Script Function Filter showing all functions inside a script

Tìm và thay thế

widget Tìm/Thay thế cho phép bạn tìm và thay thế mã trong một kịch bản mở. widget hỗ trợ trường hợp phù hợp, phù hợp với toàn bộ từ, và tìm kiếm bằng các biểu hiệu thường xuyên.Để mở nó, hãy nhấn CtrlF trên Windows hoặc F trên Mac.

Find/Replace widget labeled

Phản hồi thời gian thực

Phân tích kịch bản

Cửa sổ Phân tích kịch bản , có thể truy cập từ tab Xem, thực hiện phân tích tĩnh trên các kịch bản của bạn và hiển thị các lỗi và cảnh báo hoạt động.Để biết thêm thông tin về các lỗi và cảnh báo, hãy xem tài liệu Luau linting.

Script with various marked errors
Lỗi kịch bản được phát hiện trong Trình soạn thảo kịch bản
Script Analysis window with details on marked errors from script
Lỗi được giải thích trong cửa sổ Phân tích kịch bản

Thành phẩm

Cửa sổ Thoát có thể truy cập từ trang Xem , hiển thị các lỗi được thu thập từ việc chạy các tập lệnh, tin nhắn từ Roblox Engine, tin nhắn từ các cuộc gọi đến print() , và lỗi từ các cuộc gọi đến warn() .Đối với chi tiết về cách cài đặt nó cho dòng công việc của bạn, xem Output .

Hỗ trợ mã

Hỗ trợ mã là một tính năng gợi ý các dòng hoặc chức năng của mã khi bạn gõ, giúp bạn lập trình hiệu quả hơn và tập trung hơn.Dựa trên các bối cảnh từ bình luận và mã của bạn, các đề xuất sẽ được kích hoạt theo hai cách:

  • Tự động khi bạn tạm dừng trên một dòng trong vài giây và mô hình AI có đủ ngữ cảnh cho một lời khuyên.
  • Thủ công với lối tắt Alt trên Windows hoặc trên Mac (bạn có thể tùy chỉnh lối tắt này).

Nhấn Tab để chấp nhận một đề xuất, hoặc bỏ qua nó bằng cách tiếp tục gõ.Hiện tại, kịch bản của bạn cần chứa ít nhất một vài dòng mã để kích hoạt một đề xuất.

Cải thiện đề xuất

Để có được các gợi ý chính xác và liên quan hơn, được khuyến khích bạn tuân theo các thực hành lập trình sạch, bất kể sự hỗ trợ, và:

  • Phá vỡ mã của bạn thành các chức năng nhỏ hơn.
  • Sử dụng tên kịch bản mô tả bắt lấy ý định chung của những gì mỗi kịch bản làm.Ví dụ, đặt tên cho một kịch bản SyncCustomSounds thay vì chỉ Sounds .
  • Gán tên mô tả cho các tham số, chức năng và kịch bản.Ví dụ, đặt tên cho một phần GreenSphere thay vì chỉ đơn giản là grs , hoặc đặt tên cho một chức năng generateSphere() thay vì gen() .Sử dụng chức năng được đặt tên so với chức năng vô danh cũng có thể tạo ra lời gợi ý tốt hơn.
  • Bền vững bao gồm các bình luận được viết tốt mô tả nhiệm vụ bạn đang thực hiện và những đầu vào/đầu ra nên là gì
    • Xem xét bao gồm một số cuộc gọi mẫu với kết quả mong đợi trong phần bình luận.
    • Gợi ý cách giải quyết một vấn đề, ví dụ -- Use raycast .
    • Sử dụng chính xác chức năng hoặc tên biến mà bạn đã xác định, ví dụ -- Create 10 greenSphere objects thay vì -- Create 10 spheres .
  • Nếu bạn là một lập trình viên mới, hãy bắt đầu với các dự án cơ bản như "làm cho người chơi nhảy khi chạm vào phần" hoặc sử dụng công cụ để tạo các đoạn mã nhỏ mà bạn có thể mở rộng khi kiến thức của bạn phát triển.

Hạn chế

Công cụ giúp tự động hóa các nhiệm vụ lập trình cơ bản nhưng không phải lúc nào cũng đề xuất mã hoàn hảo. Các giới hạn đã biết bao gồm:

  • Kích hoạt thủ công không luôn luôn tạo ra một đề xuất.
  • Các đề xuất được học máy từ một bộ mã và do đó có thể phản ánh một số hạn chế của mã họ được đào tạo trên.Ví dụ, các đề xuất có thể không sử dụng API mới hơn vì lợi ích của API cũ hơn, hoặc chúng có thể sử dụng Lua thay vì Luau.
  • Công cụ có thể tạo ra thông tin sai lầm hoặc gây nhầm lẫn không hữu ích cho mục đích của bạn.
  • Các bộ lọc nội bộ cố gắng chặn ngôn ngữ tấn công, nhưng chúng không bao quát tất cả và có khả năng công cụ có thể tạo ra thông tin xúc phạm hoặc có phiên bản.
  • Các đề xuất có thể giống nhau, tương tự hoặc khác nhau giữa các người dùng, ngay cả với cùng một lời nhắc. Tuy nhiên, mã của bạn sẽ không bao giờ được chia sẻ với người khác.
  • Lời đề nghị có thể không hoàn chỉnh do chiều dài giới hạn của đầu ra từ các mô hình học.
  • Có một giới hạn hàng ngày cho số lượng đề xuất và, một khi giới hạn được đạt đến, bạn sẽ không nhận được bất kỳ đề xuất nào cho đến ngày hôm sau.

Bảo mật mã

Hiện tại, Roblox không sử dụng bất kỳ dữ liệu công khai nào để luyện tập các mô hình học.Công cụ chỉ sử dụng một phần nhỏ của các tài nguyên thị trường miễn phí để điều chỉnh các mô hình ngôn ngữ lớn và phần phụ đã vượt qua các kiểm tra khác nhau về chất lượng và bảo mật.

Ngoài ra, tất cả các đề xuất được tạo ra bởi mô hình AI và không chuyển từ một người dùng sang người dùng khác.Vì mã của bạn không được sử dụng cho việc huấn luyện mô hình, nó sẽ không được đề xuất cho các người dùng khác của Hỗ trợ mã , với một ngoại lệ là mã được đăng vào các mục thị trường miễn phí.

Nhiều con trỏ

Trình soạn thảo kịch bản hỗ trợ sử dụng nhiều con trỏ để thực hiện chỉnh sửa cùng một lúc.Bạn có thể thêm con trỏ dựa trên nhu cầu của bạn bằng cách nhấp chuột hoặc phím tắt bàn phím.Con trỏ ban đầu được gọi là con trỏ chính và các con trỏ bổ sung được gọi là con trỏ thứ cấp .

  • Chỉnh sửa bạn thực hiện tại bản sao con trỏ chính sang các con trỏ thứ cấp.Mỗi lần chỉnh sửa được tính là một hành động, vì vậy việc hoàn tác/thực hiện lại chỉnh sửa áp dụng cho tất cả các con trỏ.
  • Các widget như hoàn thành tự động xuất hiện trên con trỏ chính nhưng không phải là con trỏ thứ cấp.
  • Tất cả các phím tắt tiêu chuẩn cho công việc chỉnh sửa kịch bản bằng cách chỉnh sửa nhiều con trỏ bao gồm việc phân tách mã, bật/tắt bình luận và xóa các dòng.

Bảng sau đây tổng hợp các luồng công việc nhiều con trỏ và các lối tắt của chúng.

LệnhCửa sổMáy Mac
Thêm/bỏ con trỏ tại vị trí chuột Alt + nhấp + nhấp
Loại bỏ con trỏ được thêm gần đây nhất CtrlUU
Thêm/sửa con trỏ khi kéo chuột Alt + kéo + kéo
Thêm con trỏ trên/dưới CtrlAlt  / CtrlAlt  /
Thêm con trỏ vào lựa chọn phù hợp tiếp theo CtrlDD
Thêm con trỏ vào mọi lựa chọn phù hợp ShiftAltLShiftL
Chọn cột/khối ShiftAlt + kéoShift + kéo
Chia lựa chọn thành các dòng ShiftAltIShiftI

Thêm con trỏ

Bạn có thể thêm con trỏ bằng cách kết hợp các phím tắt bàn phím và các thao tác chuột.Các con trỏ hợp nhất nếu chúng chiếm cùng một không gian, chẳng hạn như nếu bạn thêm các con trỏ bằng phím mũi tên hoặc xóa tất cả các ký tự giữa các con trỏ.

Tại vị trí chuột

Để thêm một con trỏ tại vị trí con trỏ của bạn:

  1. Giữ Alt trên Windows hoặc trên Mac.

  2. Bấm vào nơi bạn muốn thêm con trỏ.

Với kéo chuột

Bạn có thể kéo chuột để thêm con trỏ vào một lựa chọn, chia một lựa chọn nhiều dòng thành các dòng hoặc chọn các cột và khối mã/không gian trống.

Để thêm một con trỏ vào một lựa chọn mã thông qua kéo:

  1. Giữ Alt trên Windows hoặc trên Mac.

  2. Nhấp và kéo chuột qua lựa chọn mã.

Trên và dưới con trỏ chính

Để thêm một con trỏ ngay trên hoặc dưới con trỏ chính:

  1. Nhấn và giữ CtrlAlt trên Windows hoặc trên Mac.

  2. Nhấn mũi tên hoặc .

Để phù hợp với lựa chọn

Bạn có thể thêm con trỏ vào tất cả các trận phù hợp của một lựa chọn hoặc vào trận phù hợp tiếp theo/trước đó, và tùy chọn bật/tắt xem các trận phù hợp có nhạy cảm với chữ hoa hay không và/hoặc phù hợp với toàn bộ từ.

Để thêm một con trỏ cho tất cả các trận phù hợp của một phần được chọn:

  1. Chọn mã bạn muốn tìm kiếm phù hợp.

  2. Nhấn ShiftAltL trên Windows hoặc ShiftL trên Mac.

Loại bỏ con trỏ

Bạn có thể xóa con trỏ bằng các phím ngắn bàn phím và cử động chuột sau đây.Ngoài ra, bạn có thể thoát khỏi chỉnh sửa nhiều con trỏ bằng cách nhấn Esc .

Tại vị trí chuột

Để xóa một con trỏ:

  1. Nhấn và giữ Alt trên Windows hoặc trên Mac.

  2. Nhấp vào con trỏ bạn muốn xóa.

Gần đây nhất thêm

Để xóa con trỏ được thêm gần đây nhất, hãy nhấn CtrlU trên Windows hoặc U trên Mac.

Sao chép và dán con trỏ

Sao chép một lựa chọn mã bao gồm các con trỏ bên trong.Hành vi của dán phụ thuộc vào số lượng con trỏ tại nguồn và số lượng con trỏ tại đích:

  • Nếu số lượng con trỏ giống nhau, thì mỗi con trỏ sao chép được dán vào mỗi con trỏ đích tương ứng.
  • Nếu số lượng con trỏ khác nhau, thì mỗi con trỏ tại điểm đến nhận toàn bộ dán với mỗi con trỏ sao chép là một dòng mới.

Định dạng trên loại hình

Nhấn Enter/Return sẽ tự động gán lại mỗi con trỏ tại dòng mới so với dòng trước.Nếu dòng trước bắt đầu với một khối chưa hoàn thiện, người soạn thảo sẽ cố gắng hoàn thành nó.

Cài đặt biên tập

Nhiều tùy chọn tùy chỉnh có thể truy cập thông qua Tập tin > Tùy chỉnh Studio ( > trên Windows; trên Mac).

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

Các lựa chọn được sửa đổi phổ biến bao gồm:

Tùy chọnMô tả
Phông chữ Mặt phông và kích thước cho mã trong trình soạn thảo.
Chiều rộng Tab Số không gian đại diện cho một Tab khoảng cách.
Phân cách bằng khoảng trống Nếu được bật, các khoảng trống tương đương với Chiều rộng tab được chèn với Tab nhấn.
Đóng gói văn bản Nếu được bật, các dòng mã dài hơn cuộn sang dòng tiếp theo.
Tùy chỉnh màu Trình soạn thảo kịch bản Cài đặt màu cho các thành phần mã, màu lựa chọn và nhiều hơn nữa.Sau khi chọn một cấu hình, bạn có thể đặt các màu cụ thể cho các lựa chọn như Màu lựa chọnMàu bình luận .

Tổ hợp phím ngắn

Trình soạn thảo kịch bản có các phím ngắn sau.Bạn cũng có thể truy cập nhiều lệnh từ tab Tập lệnh xuất hiện trong thanh công cụ Studio mỗi khi bạn xem hoặc chỉnh sửa một tập lệnh.

LệnhCửa sổMáy Mac
Đóng kịch bản CtrlWW
Mở lại kịch bản đã đóng cuối cùng CtrlShiftTShiftT
Mở nhanh CtrlPP
Hiển thị kịch bản trong Explorer CtrlAltKK
Xoay vào Ctrl==
Thu nhỏ Ctrl--
Xóa phóng to kịch bản Ctrl00