ตรวจสอบและล้างแคช Hugging Face บน Mac

ตรวจสอบตำแหน่งและปกป้องผลงาน

ตำแหน่งทั่วไปคือ ~/.cache/huggingface/hub โดย HF_HUB_CACHE เลือกแคชของที่เก็บบน Hub ส่วน HF_HOME ครอบคลุมกว้างกว่า หากไม่ได้ตั้ง HF_HOME ค่า XDG_CACHE_HOME อาจมีผลต่อตำแหน่งเริ่มต้น และ cache_dir อาจเลือกพาธอื่น ตรวจแอป GUI เทอร์มินัล และ notebook แยกกัน HF_HOME อาจมีข้อมูลยืนยันตัวตน จึงไม่ควรลบทั้งหมดหรือเผยแพร่เนื้อหา

checkpoint ที่ปรับฝึกเอง, adapter, การแก้ tokenizer, ผลการแปลง, ข้อมูลส่วนตัว และการตั้งค่าโปรเจ็กต์อาจดาวน์โหลดใหม่ไม่ได้ ตรวจสอบสำเนาสำรอง เพราะบางเครื่องมือข้ามแคชที่มี CACHEDIR.TAG หากยังไม่ทราบวิธีกู้คืนให้เก็บไว้ และอย่าตัดสินจากวันเข้าถึงที่เก่าเพียงอย่างเดียว

แสดง ID แบบเต็มและคำเตือน

หยุดแอป การดาวน์โหลด และงานที่ใช้แคช รัน hf cache ls --no-truncate ตามด้วย hf cache ls --revisions --no-truncate --show-warnings เวอร์ชันที่ตรวจซ่อนคำเตือนรายละเอียดตามค่าเริ่มต้น หากใช้แคชกำหนดเองให้ระบุ --cache-dir เดิมทุกคำสั่ง ตรวจหาปัญหาการอ่านหรือโครงสร้าง จดพื้นที่ใช้และพื้นที่ว่าง และไม่เผยแพร่รายชื่อที่เก็บส่วนตัว

ตรวจขอบเขตก่อนยืนยัน

hf cache rm ต้องใช้ ID เต็มจาก CLI สำหรับโมเดลให้คง model/ ไว้ ไม่ใช้ชื่อโฟลเดอร์ที่ขึ้นต้นด้วย models-- แทน หากเลือก revision เดียว ใช้ hash เต็มและตรวจว่าอยู่ในที่เก็บใด เริ่มด้วย --dry-run ผลลัพธ์เป็นสรุปเป้าหมายกับพื้นที่โดยประมาณ ไม่ใช่รายชื่อทุกไฟล์ การเลือกที่เก็บจะครอบคลุม revision ทั้งหมดที่แคชไว้ในนั้น

เมื่อตรวจแล้วจึงเอา --dry-run ออก โดยใช้เป้าหมาย พาธ และคำถามยืนยันเดิม หากรายการเปลี่ยนหรือดูตัวอย่างไม่สำเร็จ ให้หยุดลบและหาสาเหตุ ไฟล์จะถูกลบตรง ๆ ไม่เข้าถังขยะ การกู้คืนต้องใช้สำเนาสำรองหรือสิทธิ์ดาวน์โหลดใหม่ snapshot และบางโครงสร้างที่เก็บอาจใช้ blob ร่วมกัน ให้ตัวจัดการแคชดูแลการอ้างอิง อย่าบวกขนาดที่แสดงตรง ๆ

แยก prune และแคชชนิดอื่น

ในเวอร์ชัน 2.0.0 ที่ตรวจ hf cache prune --dry-run แสดง revision แบบ detached และการดาวน์โหลดที่ยังไม่เสร็จ แม้ไม่มีการอ้างอิงแบบมีชื่อ โปรเจ็กต์อาจล็อกให้ใช้ revision นั้น ตรวจทีละเป้าหมายและหยุดการดาวน์โหลดที่กำลังทำงาน ครั้งแรกควรเริ่มจากเป้าหมายเดียวที่เข้าใจชัดเจน

ข้อมูลที่สร้างใน HF_DATASETS_CACHE ต่างจากไฟล์ดาวน์โหลดของ Hub ตรวจข้อมูลส่งผ่าน Xet และผลลัพธ์ local_dir แยกกัน พร้อมเก็บการแก้ไขในเครื่อง การลบทั้ง HF_HOME ไม่ทดแทนการแยกตรวจนี้

ทดสอบโมเดลที่เก็บไว้จริง

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

หากย้ายไปดิสก์ภายนอก ให้ตรวจพื้นที่ สิทธิ์ และการรองรับ symbolic link คัดลอกทั้งลิงก์และปลายทาง ตั้งค่าทุกแอปและทดสอบโมเดลก่อนลบต้นฉบับ โดยต่อดิสก์ไว้ตลอดช่วงที่ใช้งาน

ขอบเขตการตรวจสอบ

วันที่ 2026-09-29 ใช้ huggingface_hub 2.0.0 ทดสอบแคชจำลองชั่วคราวแบบออฟไลน์ ทั้งรายการ ID เต็ม คำเตือน และ dry-run ตัวอย่างไม่เปลี่ยนไฟล์ การลบ revision เก่ายังคง revision ปัจจุบันและข้อมูลร่วมไว้ ไม่ได้ทดสอบโมเดลจริง แคชผู้ใช้ การล้าง blob ข้ามที่เก็บ หรือการย้ายดิสก์ จึงไม่รับประกันพื้นที่คืนแบบตายตัว ตรวจเวอร์ชันของคุณด้วย hf cache --help

สิ่งที่ต้องตรวจสอบก่อนลบ

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

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