Swift Academy · Pelajaran

Asas SwiftFormat / SwiftLint

Sediakan SwiftFormat untuk memformat kod secara automatik dan SwiftLint untuk menandakan isu gaya. Jalankannya secara setempat dan dalam CI dengan peraturan mudah yang mesra pemula.

Pelajaran 1 daripada 38 langkah

Asas SwiftFormat / SwiftLint ialah pelajaran Swift Academy percuma di CoddyKit. Ini ialah pelajaran 1 daripada 3. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Swift Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Swift Academy merangkumi sejumlah 3 pelajaran.

Mengapa pemformatan dan pemeriksaan kod?

Matlamat: Pastikan kod konsisten dan mudah dibaca.

  • SwiftFormat → formatkan sumber secara automatik
  • SwiftLint → tandakan isu gaya
  • Jalankan secara setempat dan dalam CI untuk kualiti yang konsisten

SwiftFormat: cara bermula

SwiftFormat menulis semula fail kepada gaya yang seragam. Simpan fail .swiftformat dalam repositori dan jalankannya sebelum membuat commit.

// Install & run (examples):
//   mint install nicklockwood/SwiftFormat     // via Mint
//   swiftformat .                             // format repo
//   swiftformat Sources --config .swiftformat // use config file
//
// Minimal .swiftformat (put in repo root):
// --ifdef no
// --wrapcollections before-first
// --maxwidth 100
print("SwiftFormat: run to auto-format code consistently")

SwiftLint: asas

SwiftLint menganalisis fail dan melaporkan pelanggaran. Konfigurasikan peraturan dalam .swiftlint.yml; pastikan hadnya sesuai untuk pemula.

// Install & run (examples):
//   brew install swiftlint         // macOS example
//   swiftlint lint                 // check whole repo
//   swiftlint lint --strict        // fail on warnings in CI
//
// Minimal .swiftlint.yml (example):
// disabled_rules:
//   - trailing_whitespace
// opt_in_rules:
//   - empty_count
// line_length: 100
// identifier_name:
//   min_length: 3
print("SwiftLint: report style issues with configurable rules")

Daripada pelanggaran kepada kod bersih

Pemformatan membaiki jarak dan pemisah baris; peraturan pemeriksaan gaya membimbing penamaan dan penggunaan. Pastikan contoh ringkas supaya pemula dapat melihat perbezaannya.

// BEFORE (bad spacing, short name, unused let)
//let x=1
//print(  "Hi"  )
//
// AFTER (formatted & lint-friendly):
let count = 1
print("Hi")
print("count =", count)

Aliran kerja automasi

Automatikkan kedua-dua alat: jalankan secara setempat sebelum membuat commit; dalam CI gunakan --strict untuk menyekat kemerosotan.

// Simple pre-commit idea (document in README):
//   swiftformat . && swiftlint lint --strict
//
// GitHub Actions (sketch) — put in CI config, not here:
//   - run: swiftformat --version && swiftformat .
//   - run: swiftlint lint --strict
//
// Tip: start lenient (warnings), then turn strict in CI once the repo is clean.
print("Automate: run format+lint locally and in CI")

Peraturan permulaan yang baik

Lalai yang sesuai untuk pemula:

  • line_length: 100
  • identifier_name.min_length: 3
  • benarkan koma penamat yang ringkas
  • nyahdayakan beberapa peraturan yang terlalu bising pada peringkat awal (dayakannya kemudian)

Pemformat berbanding pemeriksa gaya

Semakan ringkas: Alat manakah yang memformat kod secara automatik?

Imbas kembali

Imbas kembali: Gunakan SwiftFormat untuk menulis sumber yang bersih dan konsisten, serta SwiftLint untuk menguatkuasakan peraturan gaya. Pastikan konfigurasi ringkas, jalankan secara setempat, dan gunakan --strict sebagai syarat CI.

Percuma untuk bermula

Pelajari Swift dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus
122
Pelajaran
409

Soalan Lazim

Adakah pelajaran “Asas SwiftFormat / SwiftLint” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Swift Academy, termasuk “Asas SwiftFormat / SwiftLint”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Swift Academy merangkumi sejumlah 3 pelajaran.

Apakah yang akan saya pelajari dalam “Asas SwiftFormat / SwiftLint”?

Sediakan SwiftFormat untuk memformat kod secara automatik dan SwiftLint untuk menandakan isu gaya. Jalankannya secara setempat dan dalam CI dengan peraturan mudah yang mesra pemula. Anda berlatih Swift Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Swift Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Swift Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 1 daripada 3.

Berapa lamakah pelajaran “Asas SwiftFormat / SwiftLint” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Swift Academy ini?

Ya. Setiap pelajaran Swift Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

  1. Asas SwiftFormat / SwiftLint
  2. Panduan gaya, garis panduan reka bentuk API
  3. Mendokumentasikan kod (pengenalan DocC)
← Kembali ke Swift Academy