Trình soạn thảo Script

Trình Soạn thảo Script trong Studio là công cụ chính để lập trình trên Roblox. Đây là một môi trường tự cải tiến có thể giúp bạn viết mã hiệu quả cao, rút ngắn thời gian phát triển và lặp lại trải 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:

• Định dạng và làm nổi bật cú pháp trong mã của bạn.
• Cung cấp các cách để hoàn thành tự động các cụm từ trong mã khi bạn gõ.
• Giúp bạn điều hướng mã bằng cách nhảy đến các khai báo biến và hàm.
• Giúp bạn tìm kiếm và thay thế mã trong các script mở hoặc tất cả các script.
• Cung cấp phản hồi thời gian thực về chất lượng và hiệu suất mã của bạn.

Trình Soạn thảo Script hỗ trợ tất cả các loại script và tự động mở khi bạn tạo một script mới hoặc nhấp đúp vào một script đã tồn tại trong cửa sổ Explorer.

Tính 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 Script 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ư:

• Gợi ý thông minh về cách hoàn thành các cụm từ khi bạn gõ mà có ngữ cảnh liên quan đến mô hình dữ liệu của trải nghiệm. Ví dụ, nếu bạn có một Model trong Workspace tên là RocketShip, tính năng hoàn thành tự động sẽ gợi ý RocketShip khi bạn gõ workspace.roc và chỉ ra rằng đây là một Model.

  

  Sử dụng các phím ↑ và ↓ để duyệt các gợi ý, sau đó nhấn Tab hoặc Enter để chấp nhận một gợi ý và chèn cụm từ hoàn chỉnh.

• Tự động điền tên cho các biến và hàm mà bạn khai báo, giúp bạn tránh các lỗi chính tả phiền phức.

  

• Cửa sổ pop-up tài liệu với mẫu mã tương tự như những gì có trên tài liệu API Engine, cung cấp ngữ cảnh về cách sử dụng API.

  

• Tooltip khi di chuột qua mà bạn có thể tùy chỉnh với tài liệu mà bạn đã định nghĩa.

  

• Chẩn đoán phân tích script khi di chuột với thông tin mà bạn có thể sử dụng để gỡ lỗi.

  

• Chữ ký hàm khi bạn gõ một đối số, cung cấp cho bạn một tài liệu tham khảo về các tham số và giá trị trả về của nó.

  

Điều hướng mã

Đi đến khai báo

Bạn có thể nhảy đến khai báo của một hàm hoặc biến bằng cách giữ Ctrl trên Windows hoặc ⌘ trên Mac khi nhấp vào lệnh gọi, hoặc bằng cách nhấp chuột phải vào lệnh gọi của nó và nhấp vào Đi tới Khai biểu.

Bộ lọc hàm script

Bộ lọc Hàm Script hiển thị danh sách tất cả các hàm được khai báo trong một script. Để mở nó, nhấn AltF trên Windows hoặc ⌥F trên Mac. Khi danh sách mở, bạn có thể duyệt chữ ký cho mỗi hàm, lọc qua chúng theo tên và nhấp đúp vào một cái để nhảy đến khai báo của nó.

Tìm kiếm và thay thế

Widget Tìm/Thay thế cho phép bạn tìm kiếm và thay thế mã trong một script mở. Widget hỗ trợ các tùy chọn khớp chữ hoa/chữ thường, khớp toàn bộ từ, và tìm kiếm theo biểu thức chính quy. Để mở nó, nhấn CtrlF trên Windows hoặc ⌘F trên Mac.

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

Phân tích script

Cửa sổ Phân tích Script, có thể truy cập qua nút Phân tích trên thanh công cụ tab Script của Studio, thực hiện phân tích tĩnh trên các script của bạn và hiển thị các lỗi và cảnh báo hiện hoạt. Để biết thêm thông tin về các lỗi và cảnh báo, hãy xem tài liệu kiểm tra Luau.

Đầu ra

Cửa sổ Đầu ra hiển thị các lỗi được ghi lại từ việc chạy script, các thông điệp từ máy chủ Roblox, các thông điệp từ các lần gọi đến print(), và các lỗi từ các lần gọi đến warn().

Hỗ trợ mã

Hỗ trợ mã là một tính năng gợi ý các dòng hoặc hàm 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 ngữ cảnh từ bình luận và mã của bạn, các gợi ý sẽ được kích hoạt theo hai cách:

• Tự động khi bạn dừng lại trên một dòng trong vài giây và mô hình AI có đủ ngữ cảnh để đưa ra một gợi ý.
• Thủ công với phím tắt Alt∖ trên Windows hoặc ⌥∖ trên Mac.

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

Cải thiện gợi ý

Để nhận được các gợi ý chính xác và có liên quan hơn, bạn được khuyến nghị tuân theo các thực hành lập trình sạch, không phụ thuộc vào sự trợ giúp, và:

• Phân chia mã của bạn thành các hàm nhỏ hơn.
• Sử dụng tên script mô tả thể hiện ý định tổng thể của những gì mỗi script thực hiện. Ví dụ, đặt tên cho một script là SyncCustomSounds thay vì chỉ là Sounds.
• Đặt tên mô tả cho các tham số, hàm và script. Ví dụ, đặt tên một phần là GreenSphere thay vì chỉ đơn giản là grs, hoặc đặt tên một hàm là generateSphere() thay vì gen(). Việc sử dụng hàm có tên hơn so với hàm ẩn danh cũng có thể tạo ra những gợi ý tốt hơn.
• Luôn luôn bao gồm các bình luận được viết tốt mô tả nhiệm vụ mà bạn đang thực hiện và những gì các đầu vào/đầu ra nên là.

  • Cân nhắc bao gồm một số cuộc gọi mẫu với kết quả mong đợi trong các bình luận.
  • Gợi ý cách giải quyết một vấn đề, chẳng hạn như -- Sử dụng raycast.
  • Sử dụng tên hàm hoặc biến chính xác mà bạn xác định, ví dụ -- Tạo 10 đối tượng greenSphere thay vì -- Tạo 10 sphere.
• 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 họ chạm vào phần tử" hoặc sử dụng công cụ để tạo ra các đoạn mã nhỏ mà bạn có thể mở rộng khi kiến thức của bạn tăng lên.

Giới hạn

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

• Kích hoạt thủ công không luôn gây ra một gợi ý được tạo ra.
• Các gợi ý được học máy từ một tập hợp mã và do đó có thể phản ánh một số giới hạn của mã mà chúng được đào tạo. Ví dụ, các gợi ý có thể không sử dụng các API mới hơn mà ưu tiên các 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 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ữ xúc phạm, nhưng chúng không phải là toàn diện và có khả năng công cụ có thể tạo ra thông tin xúc phạm hoặc thiên lệch.
• Các gợi ý có thể giống nhau, tương tự hoặc khác nhau giữa các người dùng, thậm chí với cùng một yêu cầu. Tuy nhiên, mã của bạn sẽ không bao giờ được chia sẻ với người khác.
• Gợi ý có thể không đầy đủ do độ dài đầu ra hạn chế từ các mô hình học máy.
• Có giới hạn hàng ngày cho số lượng gợi ý và, một khi giới hạn đã đạt, bạn sẽ không nhận được gợi ý nào cho đến ngày hôm sau.

Quyền riêng tư mã

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

Hơn nữa, tất cả các gợi ý được tạo ra bởi mô hình AI và không chuyển từ người dùng này sang người dùng khác. Vì mã của bạn không được sử dụng cho việc đào tạo 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ệ duy nhất là mã được đăng trên các mục thị trường miễn phí.

Đa con trỏ

Trình Soạn thảo Script hỗ trợ sử dụng nhiều con trỏ để thực hiện chỉnh sửa đồng thời. Bạn có thể thêm con trỏ dựa trên nhu cầu của mình bằng cách nhấp chuột hoặc phím tắt. 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ỏ phụ.

• Các chỉnh sửa mà bạn thực hiện tại con trỏ chính sẽ được sao chép vào các con trỏ phụ. Mỗi chỉnh sửa tính là một hành động, vì vậy phục hồi/đưa lại một chỉnh sửa sẽ á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 xuất hiện trên các con trỏ phụ.
• Tất cả các phím tắt chuẩn cho việc chỉnh sửa script đều hoạt động với việc chỉnh sửa đa con trỏ, bao gồm thụt đầu dòng mã, bật tắt bình luận và xóa dòng.

Bảng sau tóm tắt các quy trình làm việc đa con trỏ và các phím tắt của chúng.

Thêm con trỏ

Bạn có thể thêm con trỏ bằng một tổ hợp các phím tắt và thao tác chuột. Các con trỏ sẽ hợp nhất nếu chúng chiếm cùng một không gian, chẳng hạn như khi bạn thêm con trỏ với các 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ỏ chuột của bạn:

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

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

Khi kéo chuột

Bạn có thể kéo chuột để thêm một 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ột và khối mã/khoảng trắng.

Để thêm một con trỏ vào một lựa chọn mã qua việc 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 phía trên hoặc phía dưới con trỏ chính:

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

2. Nhấn các phím mũi tên ↑ hoặc ↓.

Đến chọn lựa phù hợp

Bạn có thể thêm con trỏ vào tất cả các lựa chọn phù hợp của một phần đã chọn hoặc đến lựa chọn gần nhất/trước đó, và tùy chọn bật/tắt việc lựa chọn có phân biệt chữ hoa/chữ thường và/hoặc khớp toàn bộ từ.

Để thêm một con trỏ vào tất cả các lựa chọn phù hợp của một phần đã chọn:

1. Chọn mã mà bạn muốn tìm các lựa chọn phù hợp.

2. Nhấn ShiftAltL trên Windows hoặc Shift⌥L trên Mac.

Xóa con trỏ

Bạn có thể xóa các con trỏ bằng các phím tắt sau và thao tác chuột. Ngoài ra, bạn có thể thoát khỏi việc chỉnh sửa đa 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ỏ mà bạn muốn xóa.

Con trỏ được thêm gần đây nhất

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

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

Việc sao chép một lựa chọn mã bao gồm cả các con trỏ trong đó. Cách hành xử của việc 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 dán vào từng con trỏ tương ứng tại đích.
• Nếu số lượng con trỏ khác nhau, thì mỗi con trỏ tại đích sẽ nhận toàn bộ nội dung dán với mỗi con trỏ sao chép ở dòng mới.

Định dạng trên khi gõ

Nhấn enter/return sẽ tự động thụt đầu dòng mỗi con trỏ tại dòng mới tương ứng 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 chỉnh, định dạng sẽ cố gắng hoàn thiện nó.

Cài đặt trình soạn thảo

Nhiều tùy chọn tùy chỉnh có thể truy cập qua tab Trình Soạn thảo Script của Cài đặt Studio. Các tùy chọn thường được chỉnh sửa bao gồm:

Phím tắt

Trình Soạn thảo Script có các phím tắt sau.