Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

TypeScript yerel desteği

Durum: Kaynakta etkin; paketli çalışma zamanı sürümü bekliyor Kapsam: güncel durum kaynak araç zinciri ve dil hizmeti Son inceleme: 2026-09-14 Sahip: AX Code bakımcıları

AX Code, çalışma alanı denetimleri, SDK yayımı ve yerleşik JavaScript/TypeScript dil sunucusu için resmi Go tabanlı TypeScript 7.0.2 derleyicisini kullanır. Dil sunucusu gönderilen yerel yürütülebilir dosyayı doğrudan --lsp --stdio ile çalıştırır. Bir kayıt çalıştırıcısı çağırmaz veya yüzen bir dil sunucusu sürümü indirmez. AX Code kullanmak için Go araç zinciri gerekmez.

Bağımlılıkları, isteğe bağlı bağımlılıklar dahil, pnpm install ile kurun. Yerel derleyicinin eşleşen işletim sistemi ve CPU paketine ihtiyacı vardır. Bağımsız derlemeler teslimattan önce bu paketi hazırlar ve doğrular. Eksik veya uyumsuz bir ikili, sessizce bir JavaScript sunucusu başlatmak yerine eyleme geçirilebilir bir hata üretir.

Derleyici API uyumluluğu

Çalışma alanı @typescript/native değerini npm:typescript@7.0.2 olarak sabitler ve eski JavaScript Compiler API’sini içe aktaran araçlar için typescript değerini npm:@typescript/typescript6@6.0.2 olarak takma adlar. Tür denetimleri ve SDK yayımı yerel derleyiciyi kullanır. Uyumluluk API’si varsayılan dil sunucusu değildir.

Vue, Svelte ve Astro için çerçeve araçları kendi sunucu bütünleştirmesini kullanır; TypeScript kitaplık uyumluluğu derleyici eklentisi desteği oluşturmaz. SolidJS JSX dönüşümü Babel üzerinden sürer. Çalışma zamanı testleri ve yayılan yapıtlar, başarılı bir tür denetiminden bağımsız geçmelidir.

Tanılar ve bellek

Yerel TypeScript çekme tanıları kullanır. AX Code bunları, bir çağıran tanıları beklemeyi istediğinde veya tanı envanterini topladığında ister. Bir dosyayı eşitlemek tek başına tür denetimini beklemez. Düzenlemeler bağımlı önbellekli sonuçları geçersiz kılar; eskimiş, bekleyen veya başarısız envanterler toplu tanılar API’si tarafından kısmi veya bozulmuş olarak bildirilir. Başarılı bir çekme o dosyayı yeniler. Sunucu yenileme istekleri önbellekli sonuçları eskimiş işaretler; sonraki tanı isteği onları istenince yeniler. Arka plan sunucu trafiği boşta kalma ömrünü yenilemez. Dosya düzenlemeleri daha önce istenen belgeleri arka planda hâlâ yenileyebilir. Ham kayıt API’si eskimiş sonuçları sınırlı bir toplama bütçesi içinde yeniler ve eksik envanterleri reddeder; düzenleme araçları bu durumu, başarılı dosya düzenlemesini kaybetmeden açıklar. Diğer dil sunucuları mevcut itme tanısı davranışını korur.

Aynı dosya için örtüşen açık tanı beklemeleri bir isteği yalnızca aynı çalışma alanı kuşağı içinde paylaşır. Ardışık istekler hâlâ yenilenir; bir çalışma alanı değişikliği daha eski, uçuştaki bir isteğin yeniden kullanımını engeller. Arka plan ve envanter yenilemeleri, bir belge kilidini bekledikten sonra tazeliği yeniden denetler.

Başarılı yama silmeleri ve taşımaları, kaldırılan kaynak belgelerini dil hizmetinde kapatır. Başarısız yama işlemleri belge durumlarını korur. Temizliğin paylaşılan iki saniyelik bir son tarihi vardır ve aynı yamada sonraki bir işlemle yeniden oluşturulan yolları atlar. Eksik temizlik, kaydedilen düzenlemeleri geri almadan açıklanır. Sunucuya teslim zaman aşımına uğrarsa tanılar, o istemci yeniden başlayana kadar eksik kalır.

Boşta dil sunucuları normal bellek profilinde 30 dakika sonra veya AX_CODE_MEMORY_PROFILE=low ile beş dakika sonra geri alınır. Geri alma, mevcut bir dakikalık sağlık denetimi aralığında çalışır ve etkin ile kuyruklu isteklerin oturmasını bekler. Sunucular istenince yeniden başlar. AX_CODE_LSP_IDLE_MS boşta süreyi milisaniye cinsinden geçersiz kılar; 0 boşta geri almayı kapatır. Geçersiz değerler profil varsayılanını kullanır. Bu ayarlar bir süreç RAM tavanı veya makine genelinde bir bütçe koymaz. Spekülatif ön ısıtma isteğe bağlı kalır.

Bir sunucuyu geri almak tanı envanterini atar. Toplu sonuçlar, daha önce açık belgeler yeniden açılıp denetlenene veya açıkça kaldırılana kadar bozulmuş işaretli kalır. Ham envanter API’si eksik kapsamyı reddeder. Kapsam defteri 2.000 yolla sınırlıdır; taşma, proje örneği bırakılana kadar tutucu biçimde eksik kalır. Boş bir sunucuyu geri almak kapsam kaybettirmez. Düzenleme araçları kaydedilen değişiklikleri korur ve tanıların eksik olduğunu açıklar. Projenin temiz olup olmadığını kurmak için tam bir proje tür denetimi kullanın.

Yerel derleme belirli bir yerleşik bellek azalması garanti etmez. Bir bellek iddiası yapmadan önce aynı projeyi, açık belgeleri, istekleri ve süreç ağacı RSS değerini karşılaştırın.

Açık sunucu geçersiz kılması

Mevcut güvenilen bir lsp.typescript.command yapılandırması yerleşik yerel sunucuyu hâlâ geçersiz kılar. Eski bir sunucu için sunucuyu ve uyumlu TypeScript SDK’sını projeye kurup sabitleyin, sonra command değerini kurulu yürütülebilir dosyaya --stdio ile ayarlayın. Sabitlenmemiş npx komutlarından kaçının. Geçersiz kılma açıktır; yerel derleyici kullanılamadığında AX Code otomatik olarak yedeklemez.

Yukarı akış: TypeScript 7 duyurusu.

TypeScript 7.0.2 kaydedilmiş belge uyumluluğu

Yerel 7.0.2 sunucusu, dosya izleme trafiği kaydedilen düzenlemelerle örtüştüğünde daha erken bir tanı anlık görüntüsü döndürebilir. AX Code, tanıları istemeden önce tam o sunucu sürümü için değişen belgeleri kapatır ve yeniden açar. Sınırlı bir belge sorgusu, yeniden açmadan önce ertelenmiş kapatmayı boşaltır; diğer sorgular bu değiştirmeyi bekler. Bu, değişen belgenin tamamını gönderir; değişmeyen belgeler örtüşen istekleri hâlâ yeniden kullanır. Diğer sunucu sürümleri görüşülen eşitleme kiplerini korur. Kesilen bir değiştirme, dil sunucusu yeniden başlayana kadar eksik kalır.