Studio cung cấp nhiều công cụ debug thông thường được tìm thấy trong môi trường phát triển tích hợp (IDEs). Các công cụ này giúp bạn giải quyết lỗi và kiểm tra các dòng script line-by-line khi chúng chạy. Thông tin debug được hiển thị trong các cửa sổ <
Workflow chung
Nếu bạn nhận thấy một vấn đề trong trải nghiệm của bạn hoặc muốn xác minh rằng nó hoạt động như bạn định, bạn có thể debug mã liên quan đến nó như sau:
Thêm các điểm dừng vào các dòng mã bạn muốn kiểm tra.
Ở trong trang Tập lệnh, nhấp vào Chơi hoặc 2>Chạy2> trên trang thử nghiệm để bắt đầu một phiên test, cũng như gọi là một phiên debug.
Khi một script đến điểm dừng, phiên bản thử nghiệm bị tạm dừng. Làm qua mã. Kết tra Watch , Call Stack và Output các cửa sổ để giúp bạn chẩn đoán và hiểu vấn đề.
Thêm các điểm dừng chân bổ sung vào các dòng mã chưa được thi hành để kiểm tra dữ liệu bổ sung. Vô hiệu hóa hoặc xóa các điểm dừng chân mà bạn không cần nữa.
Ở trong tab Truyền thống script, nhấp vào Dừng để kết thúc phiên bản debug.
Lặp lại các bước trước cho đến khi bạn giải quyết vấn đề hoặc tìm nguyên nhân gây ra. Khi bạn học cách làm việc chung, bạn có thể tùy chỉnh các điểm dừng để chỉ dùng nếu một số điều kiện được đáp ứng, để in một thô
Sử dụng Dấu chấm dừng
Các điểm dừng là checkpoints kiểm tra hoặc "phá vỡ" sự thi hành của các script ở các dòng cụ thể. Bạn có thể sử dụng các dừng để kiểm tra và debug trải nghiệm của bạn, xem biến đổi và kiểm tra mãgọi
Để tạo một điểm dừng chuẩn ở một dòng mã, hãy nhấp chuột bên trái của thanh dòng của nó. Bạn cũng có thể nhấp chuột bên trái của thanh dòng và nhấp chuột Vào điểm dừng. Điểm dừng xuất hiện như một dấu chấm. Để tắt nó, hãy nhấp chuột vào dấu chấm.
Bước qua mã
Nếu bạn nhúc nhích một điểm dừng ở một dòng trong một script, script sẽ tạm dừng trước khi thi hành dòng đó. Một mũi tên màu vàng có tên là " debugger" cho biết màn hàng của mã nào thi hành tiếp theo.
Khi script tạm dừng, thực hiện mã sau một dòng một lúc bằng cách bước qua chúng với các nút ở Script tab. Các nút cũng xuất hiện ở góc trên cùng bên trái của Call Stack window. Khi bạn bước qua mã, hãy theo dõi cách trải nghiệm của bạn thay đổ
Bảng sau đề cập ba cách để bước qua mã. Để tiếp tục thi hành mã sau khi bạn đạt đến điểm dừng, hãy nhấp vào Tiếp tục trong Tập tin tùy chỉnh.
| Nút | Hành động | Tắt | Mô tả |
|---|---|---|---|
 | Bước vào | F11 | Nút Bước vào di chuyển debugger vào mã của chức năng trên dòng hiện tại. Nếu không có chức năng trên dòng hiện tại, debugger di chuyển đến dòng tiếp theo. |
 | Bước vượt qua | F10 | Nút Bước vào di chuyển debugger đến dòng mã tiếp theo, không di chuyển vào các chức năng. |
 | Bước ra ngoài | ShiftF11 | Nút Bước ra di chuyển debugger ra khỏi chức năng hiện tại và đến dòng code tiếp theo sau khi gọi chức năng. Nếu dòng hiện tại không nằm trong một chức năng, debugger sẽ di chuyển đến dòng tiếp theo. |
Kiểm tra mã
Khi một điểm dừng trong trải nghiệm trong một lần chơi thử, bạn có thể kiểm tra các cửa sổ Watch, Call Stack, Output và 1> Script Editor1> để tìm thông tin về các giá trị biến và thực thi chức năng. Với thông tin này,
Đồng hồ Bảng điều khiển
Cửa sổ Đồng hồ có hai tab: Biến và My Watches . Tab 1> Biến1> hiển thị thông tin về các biến hiện tại trong phạm vi, và tab 4> My Watches4> hiển thị giá trị của các biểu hữu hoặc biểu thức b
Cột Biến tab có các cột sau:
- Tên - Tên đã tuyên bố của biến.
- Ngòm – Ngòm của biến: nơi nó có thể được "thấy" và truy cập, chẳng hạn như Local, Global hoặc Upvalue.
- Giá trị – Giá hiện tại của biến.
- Type dữ liệu – Loại dữ liệu của biến.
Cột Đồng hồ của tôi có các cột sau:
- Biểu tượng – Biểu tượng bạn muốn xem.
- Giá trị – Giá trị hiện tại của biểu tượng.
- Type dữ liệu – kiểu dữ liệu của biểu tượng.
Ở trang Biến , bạn có thể lọc phạm vi của biến bằng cách nhấp vào biểu tượng lọc. Bạn cũng có thể sắp xếp các hàng bằng cách nhấp vào tên cột để sắp xếp theo. Cửa sổ mở cung cấp cả hai kiểu hiển thị mở rộng và thu nhỏ của các hàng.
Để kiểm tra mã trong cửa sổ Đồng hồ:
Nếu cửa sổ Đồng hồ không mở, thì hãy nhấp vào Đồng hồ trong trang Cuộn phim.
Khi phiên tập luyện của bạn bị tạm dừng ở một điểm dừng, hãy suy nghĩ về cách bạn mong đợi dòng hiện tại sẽ thay đổi giá trị của các biến trong script đó.
Khi bạn bước qua mã, hãy xem xét cách giá trị của biến thay đổi trong Mũ trục biến tab. Nếu bạn muốn xem một biểu tượng không ở trong tab Mũ trục biến, hãy mở tab My Watches . Click một dòng tr
So sánh giá trị của các biến và hàm từ những gì bạn mong đợi và những gì bạn thấy trong cửa sổ Watch. Nếu có sự khác biệt giữa cách bạn mong đợi biến thay đổi và cách chúng thực sự thay đổi, thì các biến hoặc các hàm tương tác với chúng có thể gây ra các vấn đề hoặc lỗi.
Gọi Cửa Sổ Stack
Cửa sổ Gọi Stack hiển thị các dòng mã sẽ được thi hành tiếp theo khi trình soạn thảo đạt đến một điểm dừng. Gọi Stack cho thấy các dòng mã bạn gọi từ và, nếu bạn gọ
Nếu bạn có nhiều điểm dừng trong các tập tin khác nhau, chúng có thể tạm dừng phiên bản thử nghiệm cùng một lúc. Bạn có thể bỏ qua điểm dừng bằng cách nhấp vào mũi tên bên cạnh tên của script trong cửa sổ Gọi để thực hiện. Nếu bạn nhấp vào Tiế
Để kiểm tra mã trong cửa sổ Call Stack trong một phiên bản dùng nghiệm thuật:
Nếu cửa sổ Gọp dữ liệu call không mở, thì hãy nhấp vào Gọp dữ liệu call trong trang Hiển thị.
Khi trải nghiệm của bạn tạm dừng ở một điểm dừng, hãy suy nghĩ về cách bạn mong đợi sự sắp xếp của các hàm chức năng để ở trong kịch bản đó.
Call Stack hiển thị thứ tự các hàm chức năng. Nếu điểm dừng là bên trong một hàm, Call Stack hiển thị các hàm chức năng đó, nếu có. Call Stack cũng hiển thị tên và số dòng của mỗi hàm. Nhấp vào dòng để bỏ chuyển sang hàm đó.
So sánh thứ tự của các hàm chức năng bạn nghĩ ở bước 2 và thứ tự thực tế từ bước 3. Nếu có sự khác biệt, thì có sự khác biệt giữa cách bạn mong đợi mã hóa và cách nó thực sự hành xử, dẫn đến những vấn đề tiềm năng và lỗi.
Cửa sổ ra
Cửa sổ Thoát, truy cập từ Cuộn dữ liệu Cuộn dữ liệu , hiển thị lỗi đã được ghi nhận từ việc thi hành các kị lỗi, thông điệp từ Roblox Engine, thông điệp từ gọi để print() và lỗi từ gọi để 2> warn()2> .
Chỉnh Sửa Skript
Trình soạn thảo được tích hợp với Editor Script . Khi trải nghiệm của bạn tạm dừng ở một điểm dừng trong một script, bạn có thể hover thẻ tên của một biến để xem giá trị của nó. Ví dụ, bạn có thể xem giá trị của một bảng mà bạn truyền làm một đại diện trong m
Cài đặt Điểm chết
Bạn có thể cấu hình các điểm dừng để dừng chỉ nếu một số điều kiện được đáp ứng, in một thông điệp đến cửa sổ Ra mắt và chạy chỉ trên client hoặc máy chủ. Bạn cũng có thể kết hợp các cấu hình này để tốt nhất cho nhu cầu debug của bạn.
Điều chỉnh giật
Bạn có thể chỉnh sửa cấu hình của một điểm dừng chơi bất kỳ lúc nào, bao gồm cả khi bạn chơi thử trong các phiên. Nếu bạn chỉnh sửa điểm dừng chơi trong một phiên chơi, các thay đổi sẽ tồn tại ngay cả sau khi bạn kết thúc phiên chơi. Bạn cũng có th
Để chỉnh cấu hình của một điểm dừng:
Nhấp chuột phải vào điểm dừng, sau đó nhấp chuột vào Chỉnh sửa điểm dừng .
Trong cửa sổ Chỉnh sửa Breakpoint , hãy cấu hình breakpoint như bạn muốn.
Điều kiện, Thông điệp đăng nhập và Tùy chọn
Đối với mỗi điểm dừng, bạn có thể thiết lập các điều kiện , Tin nhắn trò chuyện , Tiếp tục thi hành và 1> Kontext1> .
The Điều kiện is the expression that determines whether the breakpoint activates. The Điều kiện is optional. If the Điều kiện is empty, the breakpoint always activates. If the Điều kiện exists, then the breakpoint activates only
Thông điệp đăng nhập là biểu tượng in đến cửa sổ print() khi điều kiện được đáp ứng. Biểu tượng Thông điệp đăng nhập giống n
Tùy chọn Tiếp tục thi hành xác định có phải ngừng thi hành script nếu nó được kích hoạt. Nó hữu ích nếu bạn muốn ghi nhận giá trị của biến hoặc hàm trong khi không ngừng thi hành. Tùy chọn này được tắt mặc định.
Kontext của một điểm dừng chân xác định liệu điểm dừng chân nên được kích hoạt trên Cliente, Server hoặc Edit. Nếu kontext là Cliente, thì điểm dừng chân sẽ được kích hoạt trong các script bên Cliente. Nếu kontext là Server, thì điểm dừng chân
Các điểm dừng điều kiện và thời gian đăng nhập
Studio cung cấp các biến thể được tên để làm cho việc bắt đầu điểm nhanh hơn. Để bắt đầu một biến thể, chuột phải vào thanh trượt của dòng của nó, sau đó nhấp vào biến thể bạn muốn bắt đầu.
Một Điểm dừng điều kiện là một điểm dừng có điều kiện và Tiếp tục thi hành bị vô hiệu hóa. Các điểm dừng điều kiện chỉ dừng ch
Một Logpoint là một điểm dừng với một Tin nhắn Log và Tiến hành liên tục được bật. Logpoints ghi nhận tin nhắn của các biến đổi trước khi dòng chạy, vì vậy chú
Logpoints thường được hiệu quả hơn các print() tuyên bố bởi vì chúng cho phép bạn ghi nhận thông điệp đến cửa sổ print() mà không cần phải dừng hoặc khởi động lại phiên đăng nhập. So với các print tuyên bố
Vô hiệu hóa Điểm Đứt
Có nhiều cách để tắt và bật lại một điểm dừng:
- Nhấp vào biểu tượng của điểm dừng.
- Chỉnh sửa điểm dừng và mở/đóng thanh kiểm tra đã bật.
- Nhấp chuột phải vào biểu tượng breakpoint và nhấp chuột vào Disable Breakpoint hoặc Enabled Breakpoint.
Xóa Điểm Đứt
Để xóa một điểm dừng, nhấp chuột giữa vào biểu tượngcủa nó. Bạn cũng có thể nhấp chuột phải vào icon và nhấp chuột vào Delete Breakpoint .
Xóa điểm dừng một sự kiện xóa tất cả các lỗi điều kiện và thông điệp đăng nhập của nó. Nếu bạn muốn giữ điều kiện hoặc thông điệp đăng nhập cho mục đích kiểm tra trong tương lai, hãy vô hiệu hóa điểm dừng thay vào đó.
Cửa sổ Breakpoints
Cửa sổ Breakpoints hiển thị tất cả các điểm dừng trong trải nghiệm của bạn. Để mở cửa sổ Breakpoints, hãy nhấp vào tab Xem ở trên Studio, sau đó nhấp vào Breakpoints.
Cột Breakpoints có các cột sau: unlabeled, Script, Line, Source Line, Condition, Log Message và Continue Execution. Các cột unlabeled, Script và Line luôn được hiển thị, nhưng bạn có thể bật/tắt các cột khác bằng cách nhấp vào ba dấu ở góc trên cùng bên phải của cửa sổ.
Trong cột không có nhãn, (x3) nhãn cho thấy số lượng các điểm dừng trên cùng một dòng mã, và biểu tượng cho thấy cấu hình của điểm dừng. Các điểm dừng trên cùng một dòng chia sẻ cùng một Điều kiện,
Bạn có thể bật và tắt các điểm gỡ giữ bằng cách nhấp vào biểu tượng gỡ giữ của nó trong cột Đã bật. Bạn cũng có thể nhấp vào các nút sau đây để bật, vô hiệu hóa và xóa một số hoặc tất cả các điểm gỡ giữ.
| Nút | Hành động |
|---|---|
 | Vô hiệu hóa tất cả các điểm dừng. Nếu bất kỳ điểm dừng nào được vô hiệu hóa, hãy bật tất cả chúng. |
 | Xóa tất cả các điểm dừng. |
Biểu tượng Breakpoint
Biểu tượng của một điểm dừng phụ thuộc vào việc nó được bật, có điều kiện và có một thông tin nhắn. Nếu một điểm dừng có một thông tin nhắn, thì nó xuất hiện như một điểm dừng bất kể có điều kiện hay không.
| Tên | Biểu Tượng | Đã bật | Điều kiện | Tin nhắn đăng nhập |
|---|---|---|---|---|
| Điểm dừng |  | Vâng | Không | Không |
 | Không | Không | Không | |
| Điều kiện để đập |  | Vâng | Vâng | Không |
 | Không | Vâng | Không | |
| Điểm đăng nhập |  | Vâng | Có lẽ | Vâng |
 | Không | Có lẽ | Vâng |
Công cụDebug thêm
Ngoài việc tích hợp debugger, Studio cung cấp thêm các công cụ debug để bạn sửa các vấn đề và lỗi trong kinh nghiệm của mình.
Bar lệnh
thanh command dịch luật luật cho phép bạn chạy các command Luau trong khi trải nghiệm đang chạy. Nó có sẵn trong Studio từ trang xem và trong Console Nhà Phát Triển.
Bảng điều khiển của nhà phát triển
Developer Console cung cấp một loạt các chi tiết bao gồm cả client và server output, sử dụng bộ nhớ, hiệu hiệu lựcmạng và nhiều hơn nữa. Để mở Developer Console trong lúc kiểm tra hoặc chơi trải nghiệm, hãy nhập /console vào trò chuyện hoặc n
Nhật Ký
Khi một script in hoặc lỗi trong Studio hoặc the Player ứng dụng, app ghi nhận thông điệp trong một tập tin đăng nhập trong hệ thống tập tin địa phương. Các tập tin này được đặt ở nhiều nơi khác nhau tùy thuộc vào hệ điều hành.
Cửa Sổ
Để truy cập các tập tin nhật trên Windows:
- Mở Trình Quản Lý Tập Tin .
- Navigate to the %LOCALAPPDATA%\Roblox\logs directory.
- Nhấp chuột gấp đôi vào một nhật ký để mở nó. Những nhật ký có giá trị XXXXX tương tự đều đến từ cùng một phiên Studio.
Mac
Để truy cập các tập tin nhật trên Mac:
- Mở Finder .
- Ở thanh menu, chọn Đi Đi Folder... .
- Trong hộp thoại, nhập ~/Library/Logs/Roblox .
- Nhấp chuột hai vào kết quả để chuyển đến thư mục Roblox logs.
- Trong thư mục, nhấp chuột vào một trục để mở nó.
iOS
Bạn có thể thu thập những hồ sơ iOS bằng cách sử dụng Mac hoặc bằng cách sử dụng một thiết bị iOS.
Để truy cập vào các tập tin nhật ký iOS trên một Mac:
- Kết nối thiết bị iOS với một Mac.
- Mở Finder .
- Navigate to Công cụ hỗ trợ and open the Console application.
- Để lấy những ghi nhận thực tế trong ứng dụng Console, chọn thiết bị iOS từ thanh bên, nhấp vào nút Bắt đầu và tái tạo vấn đề trên thiết bị iOS.
- Để lấy dữ liệu từ các trụ cột trong ứng dụng Console, chạy sudo log collect --device-name "[iOS Device Name]" trong Terminal . Đảm bảo không có dấu chấm câu trong tên thiết bị hoặc bạn sẽ nhận được một lỗi khi chạy mệnh lệnh này.
Android
Để truy cập các tập tin nhật trên Android:
- Navigate to Cài đặt ery Hệ điều hành ery Tùy chọn nhà phát triển .
- Bật/tắt Tùy chọn nhà phát triển trên.
- Trên một máy tính, tải xuống và cài đặt Android Studio .
- Trong Android Studio, hãy nhấp vào Logcat .
- Kết nối thiết bị Android với máy tính để tự động điền Logcat bằng các hàng nhật ký.