TypeScript Academy · บทเรียน

skipLibCheck และคำประกาศแบบแยกส่วน

ใช้แฟล็กคอมไพเลอร์เพื่อเร่งโครงการขนาดใหญ่

skipLibCheck และคำประกาศแบบแยกส่วน เป็นบทเรียน TypeScript Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 3 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน TypeScript Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส TypeScript Academy มีบทเรียนทั้งหมด 4 บทเรียน

skipLibCheck คืออะไร

skipLibCheck: true บอกให้ TypeScript ข้ามการตรวจสอบชนิดข้อมูลของไฟล์ประกาศ .d.ts ทั้งหมด ซึ่งเป็นการแลกความปลอดภัยกับความเร็ว

// tsconfig.json
{
  "compilerOptions": {
    "skipLibCheck": true
  }
}

ควรใช้ skipLibCheck เมื่อใด

ใช้เมื่อไฟล์ .d.ts จากผู้ให้บริการภายนอกมีข้อผิดพลาดที่คุณแก้ไขไม่ได้ หรือในโปรเจกต์ขนาดใหญ่ที่การตรวจสอบชนิดข้อมูลของไลบรารีใช้เวลาคอมไพล์เป็นส่วนใหญ่

// Common scenario: two libraries ship conflicting .d.ts
// skipLibCheck: true silences those errors so you can focus on your code

ความเสี่ยงของ skipLibCheck

คุณอาจพลาดข้อผิดพลาดของชนิดข้อมูลจริงในไฟล์ประกาศ ซึ่งข้อผิดพลาดเหล่านี้อาจช่วยตรวจพบบั๊กที่ขอบเขตการทำงานได้ ควรใช้อย่างรอบคอบและเปิดใช้งานการตรวจสอบอีกครั้งเป็นระยะเพื่อค้นหาการถดถอย

// Risk: incorrect .d.ts in a library goes undetected
// Mitigation: enable skipLibCheck only for known-safe packages

skipDefaultLibCheck

skipDefaultLibCheck: true เป็นตัวเลือกที่เจาะจงมากกว่า โดยข้ามเฉพาะไฟล์ประกาศของไลบรารี TypeScript ในตัว (lib.d.ts) ไม่รวมไฟล์จากผู้ให้บริการภายนอก

{
  "compilerOptions": {
    "skipDefaultLibCheck": true
    // Third-party .d.ts files still checked
  }
}

การประกาศแบบแยกอิสระคืออะไร

isolatedDeclarations: true (TS 5.5+) กำหนดให้สัญลักษณ์ที่ส่งออกทุกตัวมีคำอธิบายชนิดข้อมูลอย่างชัดเจน ทำให้ TypeScript สร้างไฟล์ประกาศได้โดยไม่ต้องอนุมานชนิดข้อมูลทั้งหมด

// tsconfig.json
{
  "compilerOptions": {
    "isolatedDeclarations": true
  }
}

เหตุใด isolatedDeclarations จึงช่วยเพิ่มความเร็ว

เมื่อใช้ isolatedDeclarations สามารถสร้างไฟล์ประกาศของแต่ละไฟล์ได้อย่างอิสระ โดยไม่ต้องวิเคราะห์ส่วนที่เหลือของโปรแกรม เครื่องมือสร้างสามารถทำงานนี้แบบขนานแยกตามไฟล์ได้

// Without isolatedDeclarations:
// File A's .d.ts requires type-checking File B's return type first.
// With isolatedDeclarations:
// Each file's .d.ts generated from its explicit annotations alone.

ข้อผิดพลาด: ไม่มีคำอธิบายชนิดค่าที่ส่งกลับ

เมื่อเปิดใช้ isolatedDeclarations ฟังก์ชันที่ส่งออกโดยไม่มีคำอธิบายชนิดค่าที่ส่งกลับจะทำให้เกิดข้อผิดพลาดในการคอมไพล์

// Error with isolatedDeclarations: true
export function getUser(id: string) { return fetchUser(id); }

// Fix: add explicit return type
export function getUser(id: string): Promise<User> { return fetchUser(id); }

isolatedDeclarations และเครื่องมือรวม DTS

เครื่องมืออย่าง dts-buddy และ oxc ใช้ประโยชน์จาก isolatedDeclarations เพื่อสร้างชุดไฟล์ประกาศได้เร็วกว่า tsc มาก

# oxc with isolatedDeclarations for fast .d.ts generation
npx oxc-transform ./src --declarations

การรวมตัวเลือกทั้งสองเข้าด้วยกัน

เพื่อประสิทธิภาพสูงสุดในโมโนรีโพขนาดใหญ่ ให้ใช้ skipLibCheck: true เพื่อเพิกเฉยต่อข้อผิดพลาดในไฟล์ประกาศจากผู้ให้บริการภายนอก และใช้ isolatedDeclarations: true เพื่อสร้างไฟล์ประกาศแบบขนาน

{
  "compilerOptions": {
    "skipLibCheck": true,
    "isolatedDeclarations": true
  }
}

แนวทางการย้ายระบบ

การเปิดใช้ isolatedDeclarations กับโค้ดเบสเดิมจำเป็นต้องเพิ่มคำอธิบายชนิดค่าที่ส่งกลับให้กับฟังก์ชันที่ส่งออกทุกตัว ใช้ ts-migrate หรือการแก้ไขอัตโนมัติของ ESLint เพื่อดำเนินการในระดับใหญ่

# ESLint rule to auto-add return types:
# @typescript-eslint/explicit-function-return-type

ทบทวน: skipLibCheck และการประกาศแบบแยกอิสระ

skipLibCheck ข้ามการตรวจสอบชนิดข้อมูลของ .d.ts เพื่อเพิ่มความเร็ว ส่วน isolatedDeclarations กำหนดให้มีคำอธิบายอย่างชัดเจน เพื่อเปิดใช้การสร้างไฟล์ประกาศแบบขนานแยกตามไฟล์ ซึ่งเป็นกลไกสำคัญที่ช่วยให้เครื่องมือทำงานเร็วขึ้น

ตรวจสอบอย่างรวดเร็ว

isolatedDeclarations: true กำหนดให้ต้องมีอะไร

สิ่งที่คุณได้เรียนรู้

skipLibCheck ช่วยเพิ่มความเร็วด้วยการเพิกเฉยต่อข้อผิดพลาดในไฟล์ประกาศจากผู้ให้บริการภายนอก ส่วน isolatedDeclarations กำหนดให้ระบุชนิดค่าที่ส่งกลับของสิ่งที่ส่งออกอย่างชัดเจน ทำให้สร้างไฟล์ประกาศแบบขนานแยกตามไฟล์และทำให้กระบวนการทำงานของเครื่องมือเร็วขึ้น

คำถามที่พบบ่อย

บทเรียน “skipLibCheck และคำประกาศแบบแยกส่วน” ฟรีหรือไม่

ใช่ — ข้อความเต็มของ “skipLibCheck และคำประกาศแบบแยกส่วน” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส TypeScript Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส TypeScript Academy มีบทเรียนทั้งหมด 4 บทเรียน

คุณจะเรียนรู้อะไรในบทเรียน “skipLibCheck และคำประกาศแบบแยกส่วน”

ใช้แฟล็กคอมไพเลอร์เพื่อเร่งโครงการขนาดใหญ่ คุณปฏิบัติ TypeScript Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน

คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน TypeScript Academy หรือไม่

ไม่จำเป็นต้องมีประสบการณ์มาก่อน TypeScript Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 3 จากทั้งหมด 4 บทเรียน

บทเรียน “skipLibCheck และคำประกาศแบบแยกส่วน” ใช้เวลานานแค่ไหน

บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย

ฉันเขียนและรันโค้ดในบทเรียน TypeScript Academy นี้ได้ไหม

ได้ บทเรียน TypeScript Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ

บทเรียนทั้งหมดในหลักสูตรนี้

การวิเคราะห์การคอมไพล์ TypeScript ที่ช้า
หลีกเลี่ยงการดำเนินการกับชนิดที่มีค่าใช้จ่ายสูง
skipLibCheck และคำประกาศแบบแยกส่วน
การตรวจสอบชนิดใน CI: กลยุทธ์และเครื่องมือ

← กลับไปที่ TypeScript Academy