พื้นฐาน SwiftFormat / SwiftLint
ตั้งค่า SwiftFormat เพื่อจัดรูปแบบโค้ดอัตโนมัติ และใช้ SwiftLint เพื่อตรวจจับปัญหาด้านรูปแบบ รันทั้งในเครื่องและใน CI ด้วยกฎง่าย ๆ ที่เหมาะสำหรับผู้เริ่มต้น
พื้นฐาน SwiftFormat / SwiftLint เป็นบทเรียน Swift Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 1 จากทั้งหมด 3 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน Swift Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส Swift Academy มีบทเรียนทั้งหมด 3 บทเรียน
เหตุใดจึงต้องจัดรูปแบบและตรวจสไตล์
เป้าหมาย: ทำให้โค้ดมีรูปแบบสม่ำเสมอและอ่านง่าย
- SwiftFormat → จัดรูปแบบต้นฉบับโดยอัตโนมัติ
- SwiftLint → แจ้งปัญหาด้านสไตล์
- เรียกใช้ในเครื่องและในซีไอเพื่อรักษาคุณภาพอย่างสม่ำเสมอ
SwiftFormat: เริ่มต้นใช้งาน
SwiftFormat เขียนไฟล์ใหม่ให้มีสไตล์สม่ำเสมอ เก็บ .swiftformat ไว้ในคลังโค้ดและเรียกใช้ก่อนการส่งการเปลี่ยนแปลง
// 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: พื้นฐาน
SwiftLint วิเคราะห์ไฟล์และรายงานการฝ่าฝืนกฎ กำหนดค่ากฎใน .swiftlint.yml และควรรักษาข้อจำกัดให้เหมาะกับผู้เริ่มต้น
// 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")จากการฝ่าฝืนกฎสู่โค้ดสะอาด
การจัดรูปแบบแก้ไขช่องว่างและการขึ้นบรรทัดใหม่ ส่วนกฎตรวจสไตล์จะช่วยชี้แนะเรื่องชื่อและการใช้งาน ควรทำตัวอย่างให้เล็กเพื่อให้ผู้เริ่มต้นเห็นความแตกต่าง
// BEFORE (bad spacing, short name, unused let)
//let x=1
//print( "Hi" )
//
// AFTER (formatted & lint-friendly):
let count = 1
print("Hi")
print("count =", count)กระบวนการทำงานอัตโนมัติ
ทำให้เครื่องมือทั้งสองทำงานอัตโนมัติ: เรียกใช้ในเครื่องก่อนส่งการเปลี่ยนแปลง และในซีไอใช้ --strict เพื่อป้องกันการถดถอย
// 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")กฎเริ่มต้นที่ดี
ค่าเริ่มต้นที่เหมาะกับผู้เริ่มต้น:
- line_length: 100
- identifier_name.min_length: 3
- อนุญาตให้มีจุลภาคต่อท้ายแบบง่าย
- ปิดใช้กฎที่ส่งเสียงรบกวนบางรายการในช่วงแรก (แล้วเปิดใช้ภายหลัง)
เครื่องมือจัดรูปแบบกับเครื่องมือตรวจสไตล์
ตรวจสอบสั้น ๆ: เครื่องมือใดจัดรูปแบบโค้ดโดยอัตโนมัติ
สรุปทบทวน
สรุปทบทวน: ใช้ SwiftFormat เพื่อเขียนต้นฉบับที่สะอาดและมีรูปแบบสม่ำเสมอ และใช้ SwiftLint เพื่อบังคับใช้กฎสไตล์ ตั้งค่าการกำหนดค่าให้เรียบง่าย เรียกใช้ในเครื่อง และใช้ --strict ควบคุมซีไอ
คำถามที่พบบ่อย
บทเรียน “พื้นฐาน SwiftFormat / SwiftLint” ฟรีหรือไม่
ใช่ — ข้อความเต็มของ “พื้นฐาน SwiftFormat / SwiftLint” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส Swift Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส Swift Academy มีบทเรียนทั้งหมด 3 บทเรียน
คุณจะเรียนรู้อะไรในบทเรียน “พื้นฐาน SwiftFormat / SwiftLint”
ตั้งค่า SwiftFormat เพื่อจัดรูปแบบโค้ดอัตโนมัติ และใช้ SwiftLint เพื่อตรวจจับปัญหาด้านรูปแบบ รันทั้งในเครื่องและใน CI ด้วยกฎง่าย ๆ ที่เหมาะสำหรับผู้เริ่มต้น คุณปฏิบัติ Swift Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน
คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน Swift Academy หรือไม่
ไม่จำเป็นต้องมีประสบการณ์มาก่อน Swift Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 1 จากทั้งหมด 3 บทเรียน
บทเรียน “พื้นฐาน SwiftFormat / SwiftLint” ใช้เวลานานแค่ไหน
บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย
ฉันเขียนและรันโค้ดในบทเรียน Swift Academy นี้ได้ไหม
ได้ บทเรียน Swift Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ
บทเรียนทั้งหมดในหลักสูตรนี้
- พื้นฐาน SwiftFormat / SwiftLint
- คู่มือรูปแบบและแนวทางการออกแบบ API
- การจัดทำเอกสารโค้ด (แนะนำ DocC)