Langkau ke kandungan
CLI & Imbasan Kod

CLI & Pemeriksaan Kod: Temui Setiap Rentetan yang Belum Diterjemahkan Secara Automatik

Berhenti mencari rentetan yang dimasukkan terus ke dalam fail sumber. CLI Better i18n menggunakan pemarsian berasaskan AST untuk mengimbas keseluruhan pangkalan kod anda, mengesan teks yang belum diterjemahkan dalam komponen dan atribut JSX, melaporkan kunci yang hilang dan tidak digunakan, serta menyepadukan dengan lancar ke dalam saluran CI anda.

Pengimbasan Kod Dikuasai AST

Berbeza daripada pengimbas berasaskan regex yang menghasilkan positif palsu, Better i18n menghurai kod anda kepada Abstract Syntax Tree untuk pengesanan rentetan yang tepat dan peka konteks.

Pengesanan Rentetan Terkod Keras

Cari secara automatik setiap rentetan yang menghadap pengguna yang tidak dibalut dalam fungsi terjemahan, termasuk rentetan dalam anak JSX dan prop komponen.

Parsing Berasaskan AST

Menghurai kod sumber anda kepada Abstract Syntax Tree untuk pengesanan yang tepat dan peka konteks, menghapuskan positif palsu daripada pengimbas berasaskan regex.

Pengimbasan Nod Teks JSX

Mendedekteksi kandungan teks yang belum diterjemahkan di dalam elemen JSX, termasuk ekspresi dan literal templat yang dipaparkan secara langsung dalam komponen anda.

Pengimbasan Atribut JSX

Menemui rentetan yang dimasukkan terus ke dalam atribut JSX seperti placeholder, aria-label, dan title yang sering terlepas semasa audit i18n secara manual.

Penapisan Pintar

Mengabaikan nilai yang tidak boleh diterjemahkan seperti nama kelas CSS, laluan import, dan literal numerik supaya anda hanya melihat keputusan yang boleh diambil tindakan.

Perintah CLI untuk Pengauditan Terjemahan

Perintah check menyediakan pengalaman pengauditan yang interaktif dan mesra pembangun. Ia membandingkan kunci terjemahan yang digunakan dalam kod sumber anda dengan kunci yang disimpan dalam jauh Better i18n, menunjukkan kunci yang hilang yang memerlukan terjemahan dan kunci yang tidak digunakan yang boleh dibersihkan.

Corak kunci dinamik seperti literal templat dikesan secara automatik. Apabila kod anda menggunakan t(`key.${variable}`), CLI mengenal pasti segmen dinamik dan menyertakannya dalam laporan yang sepadan dengan corak, supaya tiada yang terlepas.

  • Lakukan audit terjemahan penuh dengan satu perintah pemeriksaan
  • Tunjukkan kunci terjemahan yang hilang yang wujud dalam kod tetapi tidak dalam stor jauh anda
  • Kenal pasti kunci yang tidak digunakan dalam stor jauh anda yang tidak lagi dirujuk dalam kod
  • Kesan corak kunci dinamik seperti literal templat dan tandakan untuk semakan
  • Jana laporan perbandingan antara penggunaan tempatan dan status terjemahan jauh

Format Output Fleksibel

Hasil pengimbasan tersedia dalam pelbagai format untuk memenuhi alur kerja anda. Output bergaya ESLint memberikan laporan yang mudah dibaca dengan rujukan fail, baris, dan lajur. Output JSON menyediakan data yang boleh dibaca mesin untuk automasi CI/CD dan perkakas tersuai.

Mod verbose memberikan ketelusan mendalam dengan log audit terperinci, ringkasan skop, dan maklumat pemasaan. Statistik pengimbasan menunjukkan bilangan fail, metrik penemuan, dan data prestasi supaya anda sentiasa mengetahui keadaan liputan terjemahan anda.

Keluaran Gaya ESLint

Laporan yang boleh dibaca manusia dengan laluan fail, nombor baris, dan rujukan lajur untuk navigasi pantas dalam mana-mana penyunting.

Output JSON

Data berstruktur yang boleh dibaca oleh mesin, sesuai untuk automasi CI/CD, papan pemuka tersuai, dan integrasi dengan alat lain.

Mod Verbose

Log audit terperinci dengan ringkasan skop, maklumat pemasaan, dan jejak resolusi ruang nama untuk nyahpepijat.

Statistik Imbasan

Jumlah fail, metrik penemuan utama, dan data prestasi supaya anda sentiasa mengetahui kesihatan liputan terjemahan anda.

Integrasi DevOps & CI/CD

Masukkan pemeriksaan terjemahan ke dalam aliran pembangunan sedia ada anda untuk mengesan rentetan yang hilang sebelum ia sampai ke persekitaran pengeluaran.

1

Integrasi Saluran Paip CI

Tambah langkah imbasan pada aliran kerja CI anda yang menggagalkan binaan apabila rentetan yang belum diterjemahkan atau kunci yang hilang dikesan.

2

Hook Pra-Komit

Jalankan imbasan pada fail staging sebelum setiap komit untuk mengesan rentetan yang belum diterjemahkan pada peringkat awal pembangunan.

3

Pengimbasan Terskop Direktori

Sasarkan direktori tertentu atau corak fail untuk mengimbas hanya bahagian pangkalan kod anda yang mengandungi kandungan yang berhadapan dengan pengguna.

4

Analisis Sedar Skop

Menyelesaikan ruang nama terjemahan secara automatik melalui penjejakan skop leksikal supaya setiap panggilan t() dipetakan kepada set kunci yang betul.

CLI i18n yang lebih baik: Pemindaian Kod yang Dibina untuk Penglokalan

CLI i18n yang lebih baik menggabungkan pengimbasan kod berasaskan AST dengan pengurusan kunci jauh dalam satu alat. Imbas pangkalan kod anda untuk mencari rentetan yang dimasukkan secara langsung, bandingkan penggunaan tempatan dengan storan terjemahan jauh anda, kenal pasti kunci yang tidak digunakan yang membesarkan saiz bundel, dan hasilkan laporan untuk saluran CI anda — semua ini tanpa meninggalkan terminal anda.

Pemindaian Sedar Skop

Tracks menggunakan Translations dan panggilan getTranslations melalui skop leksikal, mengikat setiap panggilan t() kepada ruang nama yang betul secara automatik.

Sokongan Komponen Pelayan

Sokongan penuh untuk komponen pelayan async Next.js App Router, supaya panggilan getTranslations dalam kod pelayan dikesan dan diaudit bersama penggunaan di pihak klien.

Hook Pra-Komitmen

Jalankan imbasan hanya pada fail yang diatur dengan penanda --staged, menangkap rentetan yang belum diterjemahkan sebelum ia dikomit tanpa melambatkan aliran kerja anda.

Hantar Terjemahan Tanpa Terlepas Satu Puncaian

CLI i18n yang lebih baik mengimbas kod anda, mengesan setiap rentetan yang belum diterjemahkan, dan sesuai dengan aliran paip CI anda supaya tiada apa pun sampai ke persekitaran pengeluaran tanpa terjemahan.