วิธีล้างแคช Hugging Face บน Mac
ทีม AskClean · อัปเดตเมื่อ 2026-11-02
หากต้องการคืนพื้นที่จากแคช Hugging Face บน Mac ให้หาแคชที่แอปของคุณใช้จริง ตรวจด้วย hf cache ls แล้วดูตัวอย่างการลบรีโพซิทอรี (repository) หรือ revision ที่เจาะจงด้วย hf cache rm --dry-run เก็บโมเดลที่ต้องใช้แบบออฟไลน์และงานที่คุณสร้างเองไว้ และอย่าลบ blob ที่ใช้ร่วมกันหรือทั้งโฟลเดอร์ HF_HOME โดยไม่ตรวจ

หาแคชที่แอปใช้จริง และปกป้องงานของคุณ
แคชของ Hub โดยทั่วไปอยู่ที่ ~/.cache/huggingface/hub ตัวแปร HF_HUB_CACHE กำหนดตำแหน่งแคชรีโพซิทอรีของ Hub โดยตรง ส่วน HF_HOME เปลี่ยนโฮมไดเรกทอรีของ Hugging Face ทั้งหมด และเมื่อไม่ได้ตั้ง HF_HOME ค่า XDG_CACHE_HOME อาจมีผลต่อตำแหน่งเริ่มต้น แอปยังอาจเลือกพาธอื่นด้วยอาร์กิวเมนต์ cache_dir ให้ตรวจสภาพแวดล้อมที่ใช้เปิดแอปแต่ละตัว ทั้งแอป GUI, notebook kernel และโปรเจกต์ที่รันจากเทอร์มินัล เพราะอาจตั้งค่าต่างกัน โฟลเดอร์ Hub เริ่มต้นที่ว่างเปล่าไม่ได้แปลว่าไม่มีโมเดลในเครื่อง HF_HOME อาจมีข้อมูลยืนยันตัวตนด้วย จึงอย่าลบทั้งโฟลเดอร์เพื่อล้างโมเดล และหากต้องขอความช่วยเหลือ ให้แชร์เฉพาะค่าที่เกี่ยวข้องโดยตัดข้อมูลลับออก
แยกไฟล์ที่ดาวน์โหลดมาออกจากงานที่คุณสร้างเอง เช่น checkpoint ที่ fine-tune เอง, adapter, tokenizer ที่แก้ไข, ผลการแปลงโมเดล, ชุดข้อมูลส่วนตัว, notebook, prompt และการตั้งค่าโปรเจกต์ โมเดลพื้นฐานที่ดาวน์โหลดมาอาจดาวน์โหลดใหม่ได้ แต่ adapter หรือสูตรการแปลงในเครื่องอาจมีอยู่ใน Mac เครื่องนี้เท่านั้น สำรองและตรวจสำเนาเหล่านี้ก่อนคืนพื้นที่ เครื่องมือสำรองข้อมูลบางตัวข้ามโฟลเดอร์แคชที่มีไฟล์ CACHEDIR.TAG จึงต้องตรวจว่าสำเนาสำรองมีไฟล์ที่ต้องใช้จริง ถ้ายังไม่รู้ว่าจะกู้คืนและทำให้แอปกลับมาใช้งานได้อย่างไร ให้เก็บไว้ก่อน และอย่าตัดสินจากวันที่เข้าถึงล่าสุดเพียงอย่างเดียว
ตรวจรีโพซิทอรีและ revision ก่อนเลือก
ปิดแอปและงานที่ใช้แคชก่อน แล้วรัน hf cache ls --no-truncate เพื่อดู ID รีโพซิทอรีแบบเต็ม ตามด้วย hf cache ls --revisions --no-truncate --show-warnings เพื่อดู hash ของ revision แบบเต็มและปัญหาในแคช ในเวอร์ชันที่ทดสอบ คำเตือนแบบละเอียดถูกซ่อนไว้ตามค่าเริ่มต้น หากใช้แคชที่กำหนดเอง ให้ใส่ --cache-dir ค่าเดียวกันในทุกคำสั่ง ตรวจคำเตือนเรื่องรายการที่อ่านไม่ได้หรือไม่สอดคล้องก่อนลบ เพราะการสแกนที่เสร็จสมบูรณ์ไม่ได้พิสูจน์ว่าทุกไฟล์ถูกจดจำ ตรวจโค้ดและการตั้งค่าว่ามีการระบุ revision ตายตัวไว้หรือไม่ จดขนาดโฟลเดอร์และพื้นที่ว่างก่อนเปลี่ยนแปลง และเก็บผลลัพธ์ไว้เป็นความลับหากระบุถึงโปรเจกต์ลับ
ดูตัวอย่างการลบก่อนยืนยัน
ใช้ hf cache rm กับ ID รีโพซิทอรีแบบเต็มหรือ hash ของ revision แบบเต็มจากรายการของคุณ โดยใส่ --dry-run ก่อน สำหรับรีโพซิทอรีของโมเดล ให้คงคำนำหน้า model/ ตามที่ CLI แสดง ชื่อโฟลเดอร์บนดิสก์ที่ขึ้นต้นด้วย models-- ไม่ใช่ ID เดียวกัน หากเลือก revision เดียว ให้ใช้ hash เต็มและตรวจว่าเป็นของรีโพซิทอรีใด ผลของ dry run เป็นสรุปเป้าหมายและพื้นที่ที่คาดว่าจะได้คืน ไม่ใช่รายการทุกไฟล์ และการเลือกทั้งรีโพซิทอรีจะครอบคลุมทุก revision ที่แคชไว้ หากตั้งใจลบเพียง revision เดียว ให้ระบุเป้าหมายเป็น revision
เมื่อตรวจขอบเขตแล้ว จึงรันคำสั่งเดิมโดยไม่ใส่ --dry-run ใช้เป้าหมายและไดเรกทอรีแคชเดียวกับตอนดูตัวอย่าง และคงคำถามยืนยันไว้เพื่อตรวจครั้งสุดท้าย หากรายการเปลี่ยนไปโดยไม่คาดคิด ให้ดูว่ามีแอปอื่นเริ่มทำงานหรือดาวน์โหลดข้อมูลหรือไม่ และหากดูตัวอย่างไม่สำเร็จ ให้หยุดและหาสาเหตุ revision อาจใช้ไฟล์ร่วมกัน และบางโครงสร้างแคชยังใช้ blob ร่วมกันข้ามรีโพซิทอรี การบวกขนาดที่แสดงจึงอาจนับไฟล์เดียวกันซ้ำ ให้ตัวจัดการแคชของ Hugging Face ดูแลการอ้างอิงเหล่านี้ เพราะการลบไฟล์ทีละไฟล์ใน Finder อาจกระทบ revision อื่นที่ยังต้องใช้ การลบแคชเป็นการลบไฟล์โดยตรง ไม่ผ่านถังขยะ การกู้คืนต้องใช้สำเนาสำรองหรือดาวน์โหลดใหม่ จึงควรเก็บสำเนาสำรองไว้จนกว่าการตรวจจะผ่าน โดยเฉพาะโมเดลส่วนตัว โมเดลที่ต้องขอสิทธิ์ (gated) โมเดลที่เลิกเผยแพร่แล้ว โมเดลที่แก้ในเครื่อง หรือโมเดลที่ต้องใช้แบบออฟไลน์
ตรวจทุกรายการก่อนใช้ prune และแยกแคชชนิดอื่น
ใน CLI เวอร์ชัน 2.0.0 ที่ทดสอบ hf cache prune --dry-run แสดง revision แบบ detached และไฟล์ดาวน์โหลดที่ไม่สมบูรณ์ revision แบบ detached ไม่มีการอ้างอิงแบบมีชื่อในแคช แต่โปรเจกต์อาจยังเรียกใช้ revision นั้นแบบเจาะจง จึงต้องตรวจโปรเจกต์ก่อนอนุมัติ การล้างครั้งแรกบน Mac ที่ใช้พัฒนางานควรเริ่มจากการลบเป้าหมายเดียวที่เข้าใจชัดเจน แล้วรันแอปที่เกี่ยวข้องและวัดผลซ้ำ หากจะใช้ prune ภายหลัง ให้ตรวจทุกรายการด้วยเกณฑ์เดียวกันและหยุดตัวดาวน์โหลดที่ทำงานอยู่ก่อน ไฟล์ที่ไม่สมบูรณ์อาจเป็นงานดาวน์โหลดที่ยังทำงานอยู่ ไม่ใช่งานที่ถูกทิ้ง
Hugging Face Datasets เก็บข้อมูลที่ประมวลผลแล้วในแคชของตัวเอง การลบไฟล์ดาวน์โหลดของ Hub ไม่ได้ลบข้อมูล Arrow หรือผลการแปลงจาก pipeline ของชุดข้อมูลเสมอไป เพราะ HF_DATASETS_CACHE กับ HF_HUB_CACHE ดูแลคนละขอบเขต ไฟล์ที่ดาวน์โหลดด้วย local_dir อยู่ในปลายทางที่คุณหรือแอปเลือก จึงต้องจัดการแยกจากแคชของ Hub และเก็บสคริปต์หรือไฟล์ที่แก้ไขไว้ก่อน เพราะการดาวน์โหลดใหม่ไม่คืนการแก้ไขในเครื่อง ที่เก็บข้อมูลการส่งผ่านของ Xet ก็แยกเช่นกัน หากพื้นที่ยังเต็ม ให้ตรวจแต่ละหมวดแยกกัน การลบทั้ง HF_HOME ไม่ใช่ทางลัดที่ปลอดภัย
ตรวจว่าโมเดลที่เหลือยังใช้งานได้
ทำรายการและวัดพื้นที่ซ้ำ แล้วโหลดโมเดลและ revision ที่ตั้งใจเก็บไว้ รันงานเล็ก ๆ ที่รู้ผลลัพธ์ เพราะการ import ไลบรารี Python สำเร็จไม่ได้พิสูจน์ว่าไฟล์โมเดลใช้ได้ หากต้องใช้แบบออฟไลน์ ให้ตัดการเชื่อมต่อเครือข่ายแล้วทดสอบก่อนพึ่งเครื่องนี้ในที่ที่ไม่มีอินเทอร์เน็ต ถ้าการรันครั้งถัดไปดาวน์โหลดโมเดลเดิมอีก แปลว่าอาจลบสิ่งที่งานยังต้องใช้ ให้ทบทวนสิ่งที่เลือก ความจุ หรือตำแหน่งแคช หากการตรวจล้มเหลว ให้หยุดล้าง จดชื่อโมเดล, revision, พาธแคช และข้อผิดพลาด ตรวจว่าแอปใช้สภาพแวดล้อมเดียวกับที่ตรวจ แล้วกู้จากสำเนาสำรองหรือดาวน์โหลด revision ที่ต้องใช้หลังยืนยันสิทธิ์เข้าถึงและพื้นที่ว่าง แก้ปัญหาให้เสร็จก่อนลบรายการถัดไป จะได้รู้ว่าการเปลี่ยนแปลงใดเป็นสาเหตุ
หากโมเดลที่ต้องใช้ประจำเกินความจุของ Mac ดิสก์ภายนอกอาจช่วยได้ ตรวจพื้นที่ว่าง สิทธิ์ และการรองรับ symbolic link ซึ่งเชื่อม snapshot กับ blob ที่ใช้ร่วมกัน คัดลอกทั้งลิงก์และไฟล์ปลายทางให้ครบ ตั้งค่าแอปแต่ละตัวให้ใช้ตำแหน่งใหม่และทดสอบโมเดลที่ต้องใช้จากที่นั่นก่อนลบต้นฉบับ และต่อดิสก์ไว้ทุกครั้งที่แอปเหล่านั้นต้องใช้
เราตรวจสอบคำสั่งเหล่านี้อย่างไร
เมื่อ 2026-09-29 เราทดสอบด้วย huggingface_hub 2.0.0 กับแคชจำลองแบบออฟไลน์ในโฟลเดอร์ชั่วคราว ซึ่งมี 2 revision, blob ที่ใช้ร่วมกัน 1 ไฟล์ และ blob เฉพาะของแต่ละ revision การแสดงรายการ revision ทำงานได้, dry run ของ rm และ prune ไม่เปลี่ยนไฟล์ทดสอบ และการลบ revision เก่ายังคง revision ปัจจุบันกับข้อมูลที่ใช้ร่วมกันไว้ ขณะที่ blob เฉพาะของ revision เก่าถูกลบ การทดสอบรอบที่สองยืนยันว่า --show-warnings แสดงรายการแคชที่ตั้งใจทำให้เสีย, --no-truncate แสดง ID เต็ม และ dry run รับทั้ง ID รีโพซิทอรีที่มีคำนำหน้าประเภทและ hash เต็ม การทดสอบนี้ไม่ได้ครอบคลุมการดาวน์โหลดโมเดลจริง, การ inference, แคชของผู้ใช้, การย้ายดิสก์ หรือการล้าง blob ที่ใช้ร่วมกันข้ามรีโพซิทอรี จึงคาดการณ์ไม่ได้ว่า Mac ของคุณจะได้พื้นที่คืนกี่กิกะไบต์ รัน hf cache --help ในสภาพแวดล้อมของคุณก่อน หากเวอร์ชันของคุณมีคำสั่งหรือตัวเลือกต่างออกไป ให้ทำตามเอกสารของเวอร์ชันนั้น AskClean ช่วยให้เห็นว่าพื้นที่บน Mac ถูกใช้ไปที่ไหน และรายการที่ยืนยันในการล้างดิสก์จะถูกลบอย่างถาวร ให้ใช้ CLI ของ Hugging Face จัดการ revision และไฟล์ที่ใช้ร่วมกัน และอย่าเลือกงานต้นฉบับของโปรเจกต์ไว้ในการล้าง
อะไรสร้างใหม่ได้ และอะไรต้องเก็บไว้
ตรวจแต่ละหมวดแยกกัน ตารางนี้อธิบายสิ่งที่ต้องเก็บหรือต้องใช้กู้คืน ไม่ได้ระบุไฟล์ให้ลบอัตโนมัติ และไม่ใช่การประมาณพื้นที่ที่จะได้คืน
| รายการ | จุดที่ตรวจสอบ | สิ่งที่ต้องตรวจก่อนลบ |
|---|---|---|
| รีโพซิทอรีหรือ revision บน Hub | hf cache ls --revisions | ตรวจสิ่งที่เลือกให้แน่ชัด การกู้คืนอาจต้องดาวน์โหลดใหม่และต้องมีสิทธิ์เข้าถึงรีโพซิทอรีเดิม |
| blob และ snapshot ที่ใช้ร่วมกัน | แคช Hub ที่ยืนยันตำแหน่งแล้ว | ใช้ตัวจัดการแคช เพราะ revision และในบางโครงสร้างรวมถึงรีโพซิทอรีต่าง ๆ อาจใช้ไฟล์ชุดเดียวกัน |
| revision แบบ detached | hf cache prune --dry-run | โปรเจกต์อาจยังต้องใช้ revision นั้นแบบเจาะจง แม้แคชจะไม่มีการอ้างอิงแบบมีชื่อ |
| แคชชุดข้อมูลที่สร้างขึ้น | HF_DATASETS_CACHE / การตั้งค่าแคชของ Datasets | แยกจากไฟล์ดาวน์โหลดของ Hub การสร้างใหม่อาจต้องใช้เวลาประมวลผลและข้อมูลต้นทาง |
| checkpoint, adapter และซอร์สที่สร้างเอง | โปรเจกต์และตำแหน่งสำรองข้อมูลของคุณ | เก็บงานต้นฉบับไว้ และตรวจว่าสำเนาสำรองรวมไฟล์เหล่านี้ โดยเฉพาะเมื่อเก็บอยู่ใต้โฟลเดอร์แคช |
| โฮมไดเรกทอรีและข้อมูลยืนยันตัวตนของ Hugging Face | HF_HOME | อย่าลบทั้งไดเรกทอรีเพื่อล้างแคชโมเดล |
คำถามที่พบบ่อย
ลบ ~/.cache/huggingface บน Mac ได้ไหม?
อย่าถือว่าทั้งไดเรกทอรีลบทิ้งได้ ให้หาแคช Hub ที่ใช้งานอยู่จริงก่อน เก็บข้อมูลยืนยันตัวตนและงานต้นฉบับไว้ แล้วดูตัวอย่างการลบเฉพาะรีโพซิทอรีหรือ revision ที่ระบุ ด้วยคำสั่ง hf cache ของเวอร์ชันที่ติดตั้งอยู่
ทำไมลบ revision เดียวแล้วได้พื้นที่คืนน้อยกว่าขนาดที่แสดง?
revision ต่าง ๆ อาจใช้ไฟล์ร่วมกัน และแคชบางรูปแบบยังใช้ไฟล์ร่วมกันข้ามรีโพซิทอรีด้วย ให้ดูค่าประมาณจากผลแสดงตัวอย่าง แล้วเทียบการใช้ดิสก์และพื้นที่ว่างก่อนและหลังลบ การรวมขนาดของแต่ละ revision ที่แสดงอาจนับไฟล์เดียวกันซ้ำหลายครั้ง
revision แบบ detached แปลว่าไม่มีแอปใช้แล้วหรือไม่?
ไม่ใช่ โปรเจกต์อาจระบุ revision ที่แน่นอนไว้ แม้แคชจะไม่มีการอ้างอิงแบบมีชื่อ ให้ตรวจสิ่งที่โปรเจกต์ต้องใช้ก่อน prune
หลังล้างแล้ว โมเดลยังใช้แบบออฟไลน์ได้ไหม?
ใช้ได้เฉพาะงานที่ไฟล์แคชซึ่งยังเก็บไว้ครบถ้วนรองรับเท่านั้น ให้ทดลองโหลดโมเดลตัวแทนแบบออฟไลน์ให้สำเร็จก่อนลบสำเนาสำรอง หรือก่อนพึ่งเครื่องนี้ในตอนที่ไม่มีอินเทอร์เน็ต
hf cache rm จะลบโมเดลที่ fine-tune เองด้วยไหม?
ลบได้ หากไฟล์ของคุณอยู่ในรายการแคชที่เลือก เก็บ checkpoint, adapter และไฟล์ที่แก้ไขไว้นอกรายการที่จะลบ และตรวจสำเนาสำรอง โฟลเดอร์ที่ชื่อ cache ก็อาจเป็นที่เก็บงานสำคัญสำเนาเดียวของคุณได้
แหล่งอ้างอิง