Plugin vscode resmi untuk reskrip

Anda harus memiliki Reskrip> = 9.1 diinstal secara lokal di proyek Anda, melalui NPM atau instalasi benang yang biasa. Versi yang lebih tua tidak dijamin berfungsi.
Sorotan kami bekerja dengan baik dengan tema vscode paling populer, seperti:
Satu -satunya 2 tema yang tidak kami (dan tidak dapat) mendukung, karena kurangnya pewarnaan, adalah: adalah:
CATATAN Jika tema khusus Anda tampaknya tidak banyak menyoroti (misalnya tidak ada warna untuk tag JSX kasus atas, tidak ada perbedaan antara modul dan varian), coba salah satu tema yang disarankan untuk melihat apakah itu masalahnya. Untuk info lebih lanjut, lihat posting ini.
.res , .resi , rescript.json dan file konfigurasi warisan bsconfig.json .external seperti @bs.module dan @bs.valtry , for , dll.//#region dan //#endregion . Luncurkan VS Code Quick Open ( Ctrl+P ), tempel perintah berikut, dan tekan Enter.
ext install chenglou92.rescript-vscode
Plugin diaktifkan pada file .res dan .resi . Jika Anda sudah menginstal server-bahasa-bahasa, mungkin yang terakhir diutamakan atas yang satu ini. Pastikan Anda menggunakan plugin ini ("Sintaks Rescript") daripada server-bahasa ("Sintaks Bucklescript").
Ada saluran pra-rilis yang tersedia. Ini dimaksudkan untuk menguji fitur baru dan karena itu mungkin fitur yang tidak stabil. Anda dapat mengaktifkannya dengan mengklik tombol "Switch to Pra-Release Version" pada halaman ekstensi rescript-vscode di vScode. Dari titik ini, versi pra-rilis akan selalu memiliki versi kecil yang aneh (1.5.x, 1.7.x, 2.1.x, dll.) Sementara rilis stabil bahkan memiliki versi kecil versi (1.4.x, 1.6.x, 2.0.0, dll.).
Bahkan jika saluran pra-rilis tampaknya terlalu eksperimental bagi Anda, kami masih menyarankan Anda untuk mencobanya dan mengirimkan masalah apa pun yang Anda temui. Dalam jangka panjang itu akan memberi kita pengalaman editor yang lebih baik secara keseluruhan.
| Memerintah | Keterangan |
|---|---|
| Reskrip: Buat file antarmuka untuk file implementasi ini | Membuat file antarmuka ( .resi ) untuk file .res saat ini, secara otomatis mengisi semua jenis dan nilai dalam file saat ini. |
| Reskrip: Buka file JS yang dikompilasi untuk file implementasi ini | Membuka file JS yang dikompilasi untuk file reskrip saat ini. |
| Reskrip: Switch Implementasi/Antarmuka | Sakelar antara file implementasi dan antarmuka. Jika Anda berada di file .res , perintah akan membuka file .resi yang sesuai (jika ada), dan jika Anda berada di file .resi perintah akan membuka file .res yang sesuai. Ini juga dapat dipicu dengan Alt+O keybinding. |
| Reskrip: Mulai Kode Analisis | Ini akan memulai analisis kode dalam proyek reskrip dari file yang Anda jalankan dari perintah. |
Anda akan menemukan semua pengaturan spesifik reskrip di bawah SCOPE rescript.settings .
| Pengaturan | Keterangan |
|---|---|
| Prompt untuk mulai membangun | Jika tidak ada reskrip yang sudah berjalan di proyek yang dibuka, ekstensi akan meminta Anda dan bertanya apakah Anda ingin memulai build secara otomatis. Anda dapat mematikan prompt otomatis ini melalui pengaturan rescript.settings.askToStartBuild . |
| Jalur biner reskrip | Ekstensi akan mencari keberadaan file node_modules/.bin/rescript dan menggunakan direktori sebagai binaryPath . Jika tidak menemukannya di root proyek (yang merupakan tempat rescript.json terdekat berada), ia naik folder di sistem file secara rekursif hingga menemukannya (sering kali terjadi di monorepos) atau mencapai level atas. Untuk mengganti proses pencarian ini, jalur dapat dikonfigurasi secara eksplisit menggunakan pengaturan rescript.settings.binaryPath |
| Jalur platform reskrip | Ekstensi akan mencari keberadaan direktori node_modules/rescript dan menggunakan subdirektori yang sesuai dengan platform saat ini sebagai platformPath . Jika tidak menemukannya di root proyek (yang merupakan tempat rescript.json terdekat berada), ia naik folder di sistem file secara rekursif hingga menemukannya (sering kali terjadi di monorepos) atau mencapai level atas. Untuk mengganti proses pencarian ini, jalur dapat dikonfigurasi secara eksplisit menggunakan pengaturan rescript.settings.platformPath |
| Petunjuk inlay (eksperimental) | Ini memungkinkan editor untuk menempatkan anotasi sejalan dengan teks untuk menampilkan jenis petunjuk. Aktifkan menggunakan rescript.settings.inlayHints.enable: true |
| Lensa kode (eksperimental) | Ini memberi tahu editor untuk menambahkan lensa kode ke definisi berfungsi, menunjukkan tipe lengkapnya di atas definisi. Aktifkan menggunakan rescript.settings.codeLens: true |
| Bantuan tanda tangan | Ini memberitahu editor untuk menunjukkan bantuan tanda tangan saat Anda menulis panggilan fungsi. Aktifkan menggunakan rescript.settings.signatureHelp.enabled: true |
Pengaturan default:
// Whether you want the extension to prompt for autostarting a ReScript build if a project is opened with no build running
"rescript.settings.askToStartBuild" : true ,
// Path to the directory where cross-platform ReScript binaries are. You can use it if you haven't or don't want to use the installed ReScript from node_modules in your project.
"rescript.settings.binaryPath" : null
// Path to the directory where platform-specific ReScript binaries are. You can use it if you haven't or don't want to use the installed ReScript from node_modules in your project.
"rescript.settings.platformPath" : null
// Enable (experimental) inlay hints.
"rescript.settings.inlayHints.enable" : true
// Maximum length of character for inlay hints. Set to null to have an unlimited length. Inlay hints that exceed the maximum length will not be shown
"rescript.settings.inlayHints.maxLength" : 25
// Enable (experimental) code lens for function definitions.
"rescript.settings.codeLens" : true Penganalisa kode adalah mode dalam ekstensi yang menjalankan analisis kode tambahan dalam proyek Anda. Analisis ini membantu Anda menemukan kode mati pada tingkat granular, menemukan pengecualian yang tidak ditangani, dan banyak lagi.
Penganalisa kode menggunakan reanalyze, yang tertanam dalam ekstensi, jadi Anda tidak perlu menginstal sesuatu yang ekstra untuk menjalankannya.
Anda harus mengkonfigurasi analisis kode apa yang ingin Anda jalankan, dan apa (jika ada) direktori yang ingin Anda abaikan. Konfigurasi dilakukan dengan menambahkan reanalyze di rescript.json . Anda akan mendapatkan AutoComplete untuk opsi konfigurasi apa yang valid. Anda juga dapat membaca semua tentang mengonfigurasi reanalyze di sini.
Buka Palet Perintah dan Jalankan ReScript: Start Code Analyzer . Ini akan memulai analisis kode dalam proyek reskrip dari file yang Anda jalankan dari perintah.
Kode mati disorot dalam editor, dan tindakan kode untuk menekan peringatan kode mati tersedia dalam banyak kasus.
Setelah selesai, hentikan mode Analisis Kode dengan mengklik tombol Stop Code Analyzer di bilah status editor. Ini akan menghapus semua peringatan analisis yang dilaporkan.
Saat ini tidak berfungsi untuk analisis kode mati Monorepo penuh (meskipun harus berfungsi untuk setiap paket monorepo secara individual).
Anda dapat mengonfigurasi vScode untuk memecahkan file JavaScript yang dihasilkan oleh reskrip di bawah file reskrip sumbernya. Ini akan "menyembunyikan" file yang dihasilkan di file vscode explorer, tetapi masih membuatnya dapat diakses dengan memperluas file reskrip sumber yang dimiliki mereka.
Buka pengaturan vscode Anda dan ketik:
"explorer.fileNesting.enabled" : true ,
"explorer.fileNesting.patterns" : {
"*.res" : "${capture}.mjs, ${capture}.js, ${capture}.cmi, ${capture}.cmt, ${capture}.cmj" ,
"*.resi" : "${capture}.res"
} ,Implementasi sarang ini di bawah antarmuka jika ada dan sarang semua file yang dihasilkan di bawah file reskrip utama. Beradaptasi dan tweak sesuai keinginan Anda.
Tangkapan layar hasil:

Lihat Changelog
Baca panduan berkontribusi kami
Lihat file lisensi untuk detailnya.