Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Hỗ trợ TypeScript gốc

Trạng thái: Đang hoạt động trong mã nguồn; bản phát hành runtime đóng gói còn chờ Phạm vi: chuỗi công cụ mã nguồn và dịch vụ ngôn ngữ ở trạng thái hiện tại Xem xét lần cuối: 2026-09-14 Chủ sở hữu: người bảo trì AX Code

AX Code dùng trình biên dịch TypeScript 7.0.2 chính thức viết bằng Go cho các kiểm tra không gian làm việc, phát SDK và máy chủ ngôn ngữ JavaScript/TypeScript tích hợp. Máy chủ ngôn ngữ chạy trực tiếp tệp thực thi gốc được phát hành bằng --lsp --stdio. Nó không gọi trình chạy kho đăng ký hay tải một phiên bản máy chủ ngôn ngữ trôi nổi. Không cần chuỗi công cụ Go để dùng AX Code.

Cài phụ thuộc bằng pnpm install, kể cả phụ thuộc tùy chọn. Trình biên dịch gốc cần gói OS/CPU khớp. Các bản dựng độc lập chuẩn bị và xác minh gói đó trước khi giao. Thiếu tệp nhị phân hoặc lệch phiên bản sẽ tạo một lỗi có thể hành động thay vì âm thầm khởi động một máy chủ JavaScript.

Tương thích API trình biên dịch

Không gian làm việc ghim @typescript/native vào npm:typescript@7.0.2 và giữ typescript được bí danh tới npm:@typescript/typescript6@6.0.2 cho các công cụ nhập API Compiler JavaScript kế thừa. Kiểm tra kiểu và phát SDK dùng trình biên dịch gốc. API tương thích không phải máy chủ ngôn ngữ mặc định.

Công cụ khung cho Vue, Svelte và Astro dùng tích hợp máy chủ riêng của chúng; tương thích thư viện TypeScript không thiết lập hỗ trợ plugin trình biên dịch. Biến đổi JSX của SolidJS vẫn đi qua Babel. Kiểm thử runtime và tạo tác đã phát phải đạt độc lập với một lần kiểm tra kiểu thành công.

Chẩn đoán và bộ nhớ

TypeScript gốc dùng chẩn đoán kéo. AX Code yêu cầu chúng khi bên gọi muốn chờ chẩn đoán hoặc thu thập kiểm kê chẩn đoán. Chỉ đồng bộ một tệp không chờ kiểm tra kiểu. Các sửa làm mất hiệu lực kết quả đệm phụ thuộc; kiểm kê cũ, đang chờ hoặc thất bại được API chẩn đoán gộp báo là một phần/suy giảm. Một lần kéo thành công làm mới tệp đó. Yêu cầu làm mới máy chủ đánh dấu kết quả đệm là cũ; yêu cầu chẩn đoán kế tiếp làm mới chúng theo nhu cầu. Lưu lượng máy chủ nền không gia hạn thời gian sống khi rảnh. Sửa tệp vẫn có thể làm mới các tài liệu đã yêu cầu trước đó ở nền. API hồ sơ thô làm mới kết quả cũ trong một ngân sách thu thập có giới hạn và từ chối kiểm kê chưa đầy đủ; công cụ sửa công bố điều kiện này mà không mất lần sửa tệp thành công. Các máy chủ ngôn ngữ khác giữ hành vi chẩn đoán đẩy hiện có của chúng.

Các lần chờ chẩn đoán tường minh chồng nhau cho cùng một tệp chỉ chia sẻ một yêu cầu trong cùng thế hệ không gian làm việc. Các yêu cầu tuần tự vẫn làm mới; một thay đổi không gian làm việc ngăn tái dùng yêu cầu đang bay cũ hơn. Làm mới nền và kiểm kê kiểm tra lại độ mới sau khi chờ khóa tài liệu.

Xóa và di chuyển bản vá thành công sẽ đóng các tài liệu nguồn đã gỡ trong dịch vụ ngôn ngữ. Giao dịch bản vá thất bại giữ trạng thái tài liệu của chúng. Việc dọn có hạn chung hai giây và bỏ qua các đường dẫn được tạo lại bởi một thao tác sau trong cùng bản vá. Dọn chưa hoàn tất được công bố mà không hoàn tác các sửa đã lưu. Nếu giao tới máy chủ hết thời gian, chẩn đoán vẫn chưa đầy đủ cho đến khi máy khách đó khởi động lại.

Máy chủ ngôn ngữ rảnh được thu hồi sau 30 phút ở hồ sơ bộ nhớ bình thường, hoặc năm phút với AX_CODE_MEMORY_PROFILE=low. Thu hồi chạy theo nhịp kiểm tra sức khỏe một phút hiện có và chờ các yêu cầu đang hoạt động lẫn đang xếp hàng ổn định. Máy chủ khởi động lại theo nhu cầu. AX_CODE_LSP_IDLE_MS ghi đè thời gian rảnh tính bằng mili giây; 0 tắt thu hồi khi rảnh. Giá trị không hợp lệ dùng mặc định của hồ sơ. Các thiết lập này không áp trần RAM tiến trình hay ngân sách toàn máy. Làm nóng trước mang tính suy đoán vẫn là chọn tham gia.

Thu hồi một máy chủ sẽ bỏ kiểm kê chẩn đoán của nó. Kết quả gộp vẫn được đánh dấu suy giảm cho đến khi các tài liệu đã mở trước đó được mở lại và kiểm tra, hoặc bị gỡ tường minh. API kiểm kê thô từ chối độ phủ chưa đầy đủ. Sổ độ phủ giới hạn 2.000 đường dẫn; tràn vẫn được coi là chưa đầy đủ một cách thận trọng cho đến khi thực thể dự án bị hủy. Thu hồi một máy chủ rỗng không mất độ phủ. Công cụ sửa giữ các thay đổi đã lưu và công bố rằng chẩn đoán chưa đầy đủ. Hãy dùng kiểm tra kiểu toàn dự án để xác định dự án có sạch hay không.

Biên dịch gốc không bảo đảm một mức giảm bộ nhớ thường trú cụ thể. Hãy so cùng dự án, tài liệu đang mở, yêu cầu và RSS của cây tiến trình trước khi đưa ra một tuyên bố về bộ nhớ.

Ghi đè máy chủ tường minh

Một cấu hình lsp.typescript.command đáng tin hiện có vẫn ghi đè máy chủ gốc tích hợp. Với máy chủ kế thừa, hãy cài và ghim máy chủ cùng SDK TypeScript tương thích trong dự án, rồi đặt command tới tệp thực thi đã cài đó bằng --stdio. Tránh các lệnh npx chưa ghim. Việc ghi đè là tường minh; AX Code không tự lùi khi trình biên dịch gốc không khả dụng.

Thượng nguồn: thông báo TypeScript 7.

Tương thích tài liệu đã lưu của TypeScript 7.0.2

Máy chủ gốc 7.0.2 có thể trả một ảnh chụp chẩn đoán sớm hơn khi lưu lượng theo dõi tệp chồng lên các sửa đã lưu. AX Code đóng và mở lại các tài liệu đã đổi cho đúng phiên bản máy chủ đó trước khi yêu cầu chẩn đoán. Một truy vấn tài liệu có giới hạn đẩy việc đóng bị hoãn trước khi mở lại; các truy vấn khác chờ sự thay thế này. Cách này gửi toàn bộ tài liệu đã đổi; tài liệu không đổi vẫn tái dùng các yêu cầu chồng. Các phiên bản máy chủ khác giữ chế độ đồng bộ đã thương lượng. Một lần thay thế bị gián đoạn vẫn chưa đầy đủ cho đến khi máy chủ ngôn ngữ khởi động lại.