Temu duga Rust: Bagaimanakah anda memindahkan crate yang menggunakan pengecam gen ke Rust 2024?

Gesaan dan skop

Satu pasukan sedang memindahkan beberapa crate daripada Rust 2021 ke Rust 2024. Fungsi, modul, medan, dan output makro menggunakan pengecam gen; Rust 2024 merizabkannya sebagai kata kunci, menyebabkan sesetengah crate gagal semasa penghuraian (parsing). Reka bentuk pengesanan, pembetulan, get CI, dan rollback.

Fokus pada migrasi edisi. Jangan anggap blok gen sudah stabil, dan asingkan peningkatan pengkompil daripada pertukaran edisi.

Perkara yang diuji oleh penemu duga

Menerangkan bahawa edisi mengubah peraturan penghuraian manakala crate daripada edisi berbeza masih boleh saling bergantung antara satu sama lain.
Menggunakan lint keyword_idents_2024 dan cargo fix --edition untuk mencari pengecam gen.
Menilai penamaan semula berbanding pengecam mentah untuk keserasian.
Merangkumi makro, API awam, skrip binaan, ujian, dan kebergantungan workspace.

Soalan penjelasan

Apakah edisi, MSRV, dan toolchain yang digunakan oleh setiap crate?
Adakah gen muncul dalam API awam, nama bersiri, atau antara muka makro luaran?
Adakah token yang terjejas berasal daripada kod sumber, proc macro, atau skrip binaan?
Adakah migrasi perlu menyokong Rust 2021 dan 2024 secara serentak?
Bolehkah CI menjalankan kedua-dua edisi merentasi kombinasi ciri?

Jawapan 30 saat

“Saya menginventori edisi workspace, toolchain, dan setiap sumber gen, kemudian mendayakan keyword_idents_2024. Saya menamakan semula simbol dalaman; jika API awam mesti mengekalkan ejaan tersebut, saya menggunakan pengecam mentah r#gen dan mengesahkan pemanggil dalam kedua-dua edisi. Saya menjalankan cargo fix --edition untuk perubahan mekanikal, menyemak makro dan antara muka awam, mengemas kini manifes Cargo secara manual, dan menjalankan check, test, docs, serta lint merentasi Rust 2021, Rust 2024, dan matriks ciri penuh. Setiap crate berhijrah mengikut urutan kebergantungan dengan komit yang boleh dipulihkan dan laporan keserasian.”

Reka bentuk langkah demi langkah

1. Asingkan perubahan pengkompil dan edisi

Pengkompil boleh membina edisi yang lebih lama; sesuatu edisi memilih peraturan penghuraian untuk sesebuah crate. Kunci (pin) toolchain dan fail kunci (lockfile), tetapkan garis dasar Rust 2021, dan ubah medan edition satu crate pada satu masa. Ini mengelakkan perubahan pengkompil, kebergantungan, dan bahasa daripada tersembunyi dalam satu diff yang sama.

2. Cari setiap sumber gen

Dayakan keyword_idents_2024 supaya pengecam yang sah dalam edisi lama tetapi berkonflik dalam 2024 dilaporkan. Carian statik mesti ditambah dengan pengembangan makro, token proc-macro, skrip binaan, dan ujian. Betulkan templat sebelum kod dijana dan bukannya mengedit output yang dijana.

3. Pilih penamaan semula atau pengecam mentah

Namakan semula fungsi dalaman, pemboleh ubah tempatan, dan modul untuk meningkatkan kejelasan jangka panjang. Jika API awam, nama bersiri, atau panggilan rentas crate mesti mengekalkan gen, pengecam mentah memastikan simbol boleh dialamatkan dalam edisi yang diperlukan. Anggap ia sebagai jambatan migrasi, bukan alasan untuk mengekalkan nama dalaman yang mengelirukan selama-lamanya.

rust

pub fn r#gen() -> IteratorType {
    // implementation
}

fn call() {
    let _items = r#gen();
}

4. Automatikkan pembetulan dengan semakan

cargo fix --edition menaikkan lint yang berkaitan kepada amaran dan menggunakan cadangan pengkompil seperti menukar gen kepada r#gen. Ia tidak boleh menentukan penamaan produk atau dasar API dan tidak sepatutnya menulis ganti kerja yang belum dikomit. Jalankannya pada cawangan yang bersih, semak diff makro, doctest, kod yang dijana, dan API awam, kemudian kemas kini edisi manifes secara manual.

5. Sahkan sempadan edisi

Crate daripada edisi berbeza boleh dipautkan, jadi pindahkan crate workspace secara berperingkat. CI harus menjalankan cargo check, cargo test, cargo doc, clippy, dan kombinasi ciri untuk 2021 dan 2024. Tambah contoh masa kompilasi untuk API awam supaya pemanggil tidak mengalami regresi disebabkan oleh pengecam mentah atau penamaan semula.

6. Perhati, kumpulkan kelompok, dan buat rollback

Rekodkan dapatan lint, edisi, toolchain, crate, ciri, sumber makro, dan ujian yang gagal; jangan sekali-kali log kelayakan atau input sensitif. Pindahkan leaf crate sebelum crate yang menjadi pergantungan meluas. Simpan tag lama, lockfile, dan binaan yang boleh dihasilkan semula bagi setiap kelompok (batch); jika hiliran (downstream) rosak, undurkan kelompok tersebut dan bukannya mencampurkan pembetulan separa secara manual.

Model jawapan berkualiti tinggi

“Edisi mengubah peraturan penghuraian, manakala peningkatan pengkompil adalah pemboleh ubah berasingan, jadi saya mengepin toolchain dan menetapkan garis dasar Rust 2021. Saya mendayakan keyword_idents_2024 dan menginventori kod sumber, makro, proc macro, skrip binaan, dan ujian yang menghasilkan gen. Simbol dalaman dinamakan semula; API awam yang mesti mengekalkan ejaan menggunakan r#gen, dengan pensirilan dan panggilan rentas crate diuji. Saya menjalankan cargo fix --edition, menyemak diff, mengemas kini manifes, dan menjalankan check, test, docs, serta clippy merentasi 2021, 2024, dan kombinasi ciri. Crate beralih mengikut susunan kebergantungan, dengan telemetri lint dan kegagalan serta titik rollback yang boleh dihasilkan semula.”

Kesilapan lazim

Hanya menaik taraf pengkompil → penghuraian edisi tidak pernah disahkan → pin garis dasar dan tukar edisi secara berasingan.
Hanya melakukan grep pada fail sumber → makro atau kod yang dijana masih mengeluarkan gen → lakukan lint pada sumber penjanaan token dan uji pengembangannya.
Menukar setiap nama kepada r#gen → kebolehbacaan API jangka panjang merosot → namakan semula bahagian dalaman dan simpan pengecam mentah untuk sempadan keserasian.
Menerima cargo fix tanpa semakan → API awam atau dokumentasi boleh rosak → semak setiap diff dan jalankan CI rentas edisi.
Menukar keseluruhan workspace sekaligus → regresi hiliran sukar dikesan → pindahkan mengikut topologi kebergantungan dengan titik rollback.

Soalan susulan dan respons

Bolehkah Rust 2024 menggunakan blok gen sekarang?

gen telah dirizabkan untuk meninggalkan ruang sintaks bagi blok gen pada masa hadapan. Migrasi tidak boleh menganggap bahawa ciri tersebut sudah stabil; sahkan dokumentasi toolchain semasa dan status ciri.

Adakah pengecam mentah mengubah ABI atau nama yang disirikan?

Pengecam mentah terutamanya mengubah cara penghurai membaca sesuatu nama. Sama ada ABI, refleksi, pensirilan, atau FFI berubah bergantung pada simbol awam dan penjana sebenar, jadi sahkan sempadan tersebut. Lindungi protokol luaran dengan nama wayar (wire names) eksplisit dan ujian keserasian.

Mengapa perlu mengedit Cargo.toml selepas cargo fix?

cargo fix --edition menggunakan cadangan lint peringkat kod, tetapi medan edisi masih memerlukan pengesahan dan komit yang disengajakan. Semak perubahan manifes bersama-sama dengan keputusan ujian supaya tiada crate workspace ditukar secara tidak sengaja atau tertinggal.

Temu duga Rust: Bagaimanakah anda memindahkan crate yang menggunakan pengecam gen ke Rust 2024?

Soalan