AskClean

Cách xóa bộ nhớ đệm Hugging Face trên Mac

Đội ngũ AskClean · Cập nhật 2026-11-02

Để giải phóng dung lượng bộ nhớ đệm Hugging Face trên Mac, hãy xác định bộ nhớ đệm mà ứng dụng của bạn thực sự dùng, kiểm tra bằng hf cache ls, rồi xem trước việc xóa một repository hoặc revision cụ thể bằng hf cache rm --dry-run. Giữ lại các mô hình cần dùng khi không có mạng và những gì bạn tự tạo ra. Đừng xóa mù quáng các blob dùng chung hay toàn bộ thư mục HF_HOME.

Hình minh họa khái niệm: các revision mô hình nối với khối dữ liệu dùng chung, tệp dự án được để riêng
Nhiều revision có thể dùng chung một số tệp. Hãy giữ checkpoint và dự án của bạn ở nơi riêng. Hình minh họa khái niệm.

Xác định đúng bộ nhớ đệm và bảo vệ thành quả của bạn

Bộ nhớ đệm Hub thường nằm ở ~/.cache/huggingface/hub. HF_HUB_CACHE chỉ định trực tiếp bộ nhớ đệm repository của Hub; HF_HOME thay đổi toàn bộ thư mục gốc của Hugging Face, còn XDG_CACHE_HOME có thể ảnh hưởng đến vị trí mặc định khi HF_HOME chưa được đặt. Tham số cache_dir trong một ứng dụng cũng có thể chọn vị trí khác. Hãy kiểm tra môi trường thực sự khởi chạy từng ứng dụng thay vì cho rằng ứng dụng nào cũng dùng chung thiết lập trong Terminal của bạn, và kiểm tra riêng ứng dụng có giao diện, kernel notebook và dự án dòng lệnh: thư mục Hub mặc định trống không có nghĩa là máy Mac không có mô hình nào.

HF_HOME cũng có thể chứa dữ liệu xác thực, nên đừng xóa cả thư mục chỉ để dọn mô hình đã tải, và đừng chia sẻ nội dung của nó; nếu cần nhờ hỗ trợ, chỉ gửi các thiết lập liên quan sau khi đã xóa giá trị nhạy cảm. Hãy tách phần tải về khỏi những gì bạn tự tạo: checkpoint đã tinh chỉnh, adapter, thay đổi tokenizer, kết quả chuyển đổi, tập dữ liệu riêng, notebook, prompt và cấu hình dự án. Mô hình gốc có thể tải lại, còn adapter hay công thức chuyển đổi có thể chỉ tồn tại trên máy Mac này. Hãy sao lưu và kiểm tra lại bản sao lưu trước khi dọn bất kỳ dung lượng nào liên quan đến mô hình, vì một số công cụ sao lưu bỏ qua thư mục bộ nhớ đệm có tệp CACHEDIR.TAG. Nếu chưa biết cách khôi phục một mục và cho ứng dụng chạy lại, hãy giữ nó lại.

Chúng tôi đã kiểm tra các lệnh này với huggingface_hub 2.0.0 vào ngày 29/9/2026. Hãy chạy hf cache --help trong môi trường của bạn trước; nếu phiên bản của bạn có lệnh hoặc tùy chọn khác, hãy làm theo tài liệu của phiên bản đó.

Kiểm tra repository và revision trước khi chọn

Bắt đầu với hf cache ls --no-truncate để liệt kê đầy đủ mã định danh (ID) của các repository. Sau đó chạy hf cache ls --revisions --no-truncate --show-warnings để xem đầy đủ mã băm (hash) của các revision và mọi vấn đề trong bộ nhớ đệm; ở phiên bản đã thử, cảnh báo chi tiết bị ẩn theo mặc định. Với bộ nhớ đệm Hub tùy chỉnh, hãy truyền cùng một giá trị --cache-dir cho mọi lệnh. Giữ kín kết quả nếu nó để lộ tên các dự án bảo mật.

Kích thước hiển thị của một revision có thể lớn hơn dung lượng thực sự được giải phóng khi xóa nó: các snapshot có thể dùng chung dữ liệu, và ở một số cấu trúc bộ nhớ đệm, blob còn được dùng chung giữa các repository, nên cộng dồn kích thước có thể tính trùng cùng một tệp nhiều lần. Hãy tìm hiểu các cảnh báo về mục không đọc được hoặc không nhất quán trước khi xóa. Chọn một mục tiêu cụ thể, chẳng hạn một thử nghiệm đã bỏ hoặc một revision dự án không còn dùng, và kiểm tra mã nguồn cùng cấu hình xem có revision nào được cố định (pin) không. Thời điểm truy cập có thể giúp ích, nhưng tuổi của tệp không phải là lý do để xóa: một mô hình cũ vẫn có thể cần cho một lần đánh giá thỉnh thoảng hoặc để khôi phục khi không có mạng.

  1. Đóng các ứng dụng và tác vụ đang dùng bộ nhớ đệm định dọn.
  2. Chạy hf cache ls --no-truncate, rồi hf cache ls --revisions --no-truncate --show-warnings, trên đường dẫn bộ nhớ đệm đã xác minh.
  3. Kiểm tra xem còn ứng dụng hay dự án nào cần repository và revision đã chọn không.
  4. Ghi lại kích thước thư mục hiện tại và dung lượng trống trước khi thay đổi bất cứ điều gì.

Xem trước việc xóa trước khi xác nhận

Dùng hf cache rm với một ID repository đầy đủ hoặc một hash revision lấy từ danh sách kiểm kê của bạn, và thêm --dry-run ở lần chạy đầu. Với repository mô hình, hãy giữ tiền tố model/ mà CLI hiển thị; tên thư mục trên ổ đĩa bắt đầu bằng models-- không phải là cùng một mã định danh. Với một revision, hãy dùng hash đầy đủ và kiểm tra xem nó thuộc repository nào. Bản xem trước chỉ tóm tắt mục tiêu và dung lượng ước tính giải phóng được, không liệt kê từng tệp; chọn cả repository nghĩa là xóa mọi revision đã lưu của nó, nên hãy chọn revision làm mục tiêu nếu bạn chỉ muốn xóa một bản.

Sau khi kiểm tra phạm vi, chạy lại đúng lệnh đó nhưng bỏ --dry-run, giữ nguyên mục tiêu và thư mục bộ nhớ đệm, và để nguyên lời nhắc xác nhận cho lần kiểm tra cuối. Nếu danh sách thay đổi bất ngờ, hãy kiểm tra xem có ứng dụng nào vừa khởi động lại hoặc tải thêm dữ liệu không; nếu bản xem trước thất bại, hãy dừng lại và tìm nguyên nhân. Hãy để trình quản lý bộ nhớ đệm của Hugging Face xử lý blob dùng chung và tham chiếu snapshot; xóa từng tệp trong Finder có thể ảnh hưởng đến các revision khác đang cần chúng.

Lệnh xóa bộ nhớ đệm xóa tệp trực tiếp, không chuyển vào Thùng rác. Muốn khôi phục một revision đã xóa, bạn sẽ cần một bản sao lưu dùng được hoặc phải tải lại. Hãy giữ bản sao lưu cho đến khi mọi bước kiểm tra đều đạt, nhất là với mô hình riêng tư, mô hình bị giới hạn truy cập (gated), không còn được phát hành, đã chỉnh sửa cục bộ hoặc cần dùng ngoại tuyến.

Hãy chọn mục tiêu từ chính danh sách bộ nhớ đệm của bạn, và kiểm tra kỹ cả repository lẫn revision trước khi chạy lệnh xóa.

Xem xét kỹ trước khi prune và tách riêng các bộ nhớ đệm khác

Trong CLI 2.0.0 đã kiểm chứng, hf cache prune --dry-run xem trước các revision bị tách rời (detached) và các lượt tải chưa hoàn tất. Một revision detached không còn tham chiếu có tên trong bộ nhớ đệm, nhưng dự án của bạn vẫn có thể yêu cầu chính revision đó, và CLI không thể biết bạn định dùng mô hình nào tiếp theo. Với lần dọn đầu tiên trên máy Mac dùng để phát triển, một lần xóa cụ thể dễ đánh giá hơn một lượt quét rộng. Nếu sau đó chọn prune, hãy áp dụng cùng danh sách kiểm tra cho mọi ứng viên và dừng các trình tải đang chạy trước: một tệp chưa tải xong có thể là dấu hiệu lượt tải bị gián đoạn, nhưng đừng nhầm nó với lượt tải đã bỏ dở khi một tác vụ khác vẫn đang dùng bộ nhớ đệm.

Hugging Face Datasets có thể lưu dữ liệu đã xử lý trong bộ nhớ đệm riêng: xóa phần tải về của Hub không nhất thiết xóa dữ liệu Arrow hay kết quả biến đổi do pipeline tập dữ liệu tạo ra, vì HF_DATASETS_CACHE và HF_HUB_CACHE có phạm vi khác nhau. Nội dung tải về với local_dir nằm ở thư mục do bạn hoặc ứng dụng chọn, kèm siêu dữ liệu riêng tại đó; hãy xử lý thư mục này tách biệt với bộ nhớ đệm Hub dùng chung và giữ lại mọi thay đổi cục bộ, vì tải lại không khôi phục được các chỉnh sửa của bạn. Bộ lưu trữ truyền tải Xet cũng là một phần riêng. Nếu dung lượng vẫn cao sau khi dọn revision của Hub, hãy kiểm tra riêng từng nhóm còn lại.

Kiểm tra các mô hình còn lại vẫn hoạt động

Lặp lại việc kiểm kê và đo dung lượng, rồi tải một mô hình và revision bạn định giữ và chạy một tác vụ nhỏ có kết quả đã biết; chỉ import được thư viện Python là chưa kiểm tra được tệp mô hình. Nếu cần dùng ngoại tuyến, hãy thử khi đã ngắt mạng trước khi mang máy đến nơi không có kết nối. Nếu lần chạy sau lại tải về chính mô hình đó, có thể bạn đã xóa dữ liệu mà tác vụ vẫn cần — hãy xem lại lựa chọn, dung lượng lưu trữ hoặc vị trí đặt bộ nhớ đệm, vì xóa rồi tải lại liên tục chỉ tốn thời gian và băng thông mà không giải quyết được vấn đề dung lượng.

Nếu những mô hình bạn dùng thường xuyên vượt quá dung lượng của máy Mac, ổ đĩa ngoài có thể giúp ích. Hãy kiểm tra dung lượng trống, quyền truy cập và khả năng hỗ trợ liên kết tượng trưng (symbolic link) — loại liên kết nối snapshot với blob dùng chung; khi sao chép, hãy giữ cả liên kết lẫn tệp mà chúng trỏ tới. Cấu hình từng ứng dụng dùng vị trí mới và thử các mô hình cần thiết tại đó trước khi xóa bản gốc, đồng thời giữ ổ đĩa luôn kết nối khi các ứng dụng đó cần. Nếu một bước kiểm tra thất bại, hãy tạm dừng việc dọn dẹp: ghi lại mô hình, revision, đường dẫn bộ nhớ đệm và lỗi, kiểm tra xem ứng dụng có dùng đúng môi trường bạn đã xem không, khôi phục bản sao lưu hoặc tải lại revision cần thiết, và xử lý xong lỗi đó trước khi xóa mục khác.

Chúng tôi đã kiểm tra các lệnh này như thế nào

Ngày 29/9/2026, chúng tôi tạo một bộ nhớ đệm kiểu Hub tạm thời, ngoại tuyến, gồm hai revision tổng hợp, một blob dùng chung và mỗi revision một blob riêng. Với huggingface_hub 2.0.0, việc liệt kê revision thành công, các lượt chạy thử rm và prune không làm thay đổi dữ liệu thử nghiệm, và việc xóa revision cũ giữ nguyên revision hiện tại cùng dữ liệu dùng chung của nó, chỉ xóa blob riêng của revision cũ. Một lượt kiểm tra ngoại tuyến thứ hai xác nhận --show-warnings hiện ra một mục bộ nhớ đệm bị làm hỏng có chủ đích, --no-truncate giữ nguyên ID revision đầy đủ, và lượt chạy thử chấp nhận cả ID repository có tiền tố loại lẫn hash revision đầy đủ mà không thay đổi dữ liệu thử nghiệm. Các kiểm tra này chỉ dùng tệp tổng hợp trong thư mục tạm: chúng không thử tải mô hình thật, suy luận, bộ nhớ đệm của người dùng, việc chuyển ổ đĩa hay dọn blob dùng chung giữa các repository, và không dự đoán được máy Mac của bạn sẽ giải phóng bao nhiêu gigabyte. Hãy tìm hiểu kỹ bộ nhớ đệm bị hỏng hoặc tùy chỉnh trước khi xóa mục nào.

AskClean có thể giúp bạn xem dung lượng trên máy Mac đang bị dùng ở đâu. Quét và xem trước kết quả là miễn phí; phân tích AI và dọn dẹp cần Pro. Dọn dẹp ổ đĩa sẽ xóa vĩnh viễn các mục bạn xác nhận. Hãy dùng CLI của Hugging Face để quản lý các revision đã lưu và tệp dùng chung của chúng, và giữ thành quả gốc của dự án ngoài phạm vi chọn để dọn.

Thứ gì tạo lại được, thứ gì phải giữ

Hãy kiểm tra riêng từng nhóm. Bảng này giải thích những gì bạn cần giữ hoặc khôi phục; nó không đánh dấu tệp nào để tự động xóa.

Hạng mụcNơi kiểm traCần kiểm tra gì trước khi xóa
Repository hoặc revision trên Hubhf cache ls --revisionsKiểm tra chính xác lựa chọn. Khôi phục có thể cần tải lại và quyền truy cập vào đúng repository đó.
Blob và snapshot dùng chungBộ nhớ đệm Hub đã xác minhDùng trình quản lý bộ nhớ đệm; các revision, và ở một số cấu trúc là cả các repository, có thể dùng chung tệp đã lưu.
Revision detachedhf cache prune --dry-runMột dự án vẫn có thể cần chính xác revision đó dù bộ nhớ đệm không còn tham chiếu có tên tới nó.
Bộ nhớ đệm tập dữ liệu đã tạoHF_DATASETS_CACHE / thiết lập bộ nhớ đệm của DatasetsTách biệt với phần tải về từ Hub; tạo lại có thể cần thời gian xử lý và dữ liệu gốc.
Checkpoint, adapter và mã nguồn tự tạoThư mục dự án và nơi sao lưu của bạnGiữ thành quả gốc. Xác minh bản sao lưu có chứa chúng, nhất là khi chúng nằm trong một thư mục bộ nhớ đệm.
Thư mục gốc Hugging Face và dữ liệu xác thựcHF_HOMEĐừng xóa cả thư mục này chỉ để gỡ các mục bộ nhớ đệm mô hình.

Bài kiểm tra hồi quy cục bộ dùng một bộ nhớ đệm tổng hợp rất nhỏ. Kích thước của dữ liệu thử nghiệm đó không phải là số đo hiệu năng hay ước tính mức tiết kiệm thực tế.

Câu hỏi thường gặp

Có thể xóa ~/.cache/huggingface trên Mac không?

Đừng coi cả thư mục là thứ bỏ đi được. Hãy xác định bộ nhớ đệm Hub đang dùng, giữ lại dữ liệu xác thực và thành quả gốc, rồi xem trước việc xóa từng repository hoặc revision cụ thể bằng lệnh hf cache đã cài.

Vì sao xóa một revision lại giải phóng ít hơn kích thước hiển thị?

Các revision có thể dùng chung tệp, và ở một số cấu trúc bộ nhớ đệm, các repository cũng dùng chung. Hãy xem con số ước tính trong bản xem trước, rồi so sánh dung lượng đã dùng và dung lượng trống trước và sau khi xóa. Cộng dồn kích thước hiển thị của các revision có thể tính trùng cùng một tệp.

Revision detached có nghĩa là không ứng dụng nào dùng nó?

Không. Một dự án có thể cố định chính xác một revision dù bộ nhớ đệm không còn tham chiếu có tên tới nó. Hãy kiểm tra yêu cầu của dự án trước khi chạy prune.

Sau khi dọn, mô hình có còn dùng được khi không có mạng không?

Chỉ những tệp được giữ lại và còn đầy đủ mới phục vụ được các tác vụ cần chúng. Hãy thử tải một mô hình tiêu biểu khi ngoại tuyến trước khi xóa bản sao lưu hoặc dùng máy ở nơi không có kết nối.

hf cache rm có xóa mô hình tôi đã tinh chỉnh không?

Có thể, nếu các tệp tùy chỉnh của bạn nằm trong mục bộ nhớ đệm được chọn. Hãy để checkpoint, adapter và tệp đã chỉnh sửa bên ngoài những mục định xóa, và kiểm tra bản sao lưu của chúng. Một thư mục tên là cache vẫn có thể chứa bản duy nhất của thành quả quan trọng.

Nguồn tham khảo

Thêm hướng dẫn về dung lượng mô hình và công cụ lập trình