Hỗ trợ pnpm

Hỗ trợ cho pnpm hiện đang ở trạng thái thử nghiệm. Để bật nó, hãy đảm bảo rằng biến môi trường VOLTA_FEATURE_PNPM được đặt thành 1. Trên Windows, điều này có thể được thêm vào biến môi trường người dùng hoặc hệ thống trong Cài đặt Hệ thống. Trên Linux/Mac, bạn có thể đặt giá trị bên trong script hồ sơ của mình (ví dụ: .bash_profile, .zshrc hoặc tương tự).

Vì hỗ trợ này là thử nghiệm, có thể có một số vấn đề chưa được khắc phục. Một số hạn chế đã biết được liệt kê bên dưới, tuy nhiên nếu bạn gặp bất cứ điều gì khi sử dụng pnpm với Volta không hoạt động như bạn mong đợi, vui lòng mở một issue trên GitHub của chúng tôi.

Các hạn chế đã biết

Cài đặt Toàn cục

Hiện tại, các cài đặt toàn cục (ví dụ: pnpm install -g) không được hỗ trợ và sẽ dẫn đến lỗi.

Di chuyển

Hiện tại không có di chuyển tự động, vì vậy nếu bạn previously có pnpm được cài đặt dưới dạng toàn cục của Volta, bạn sẽ cần cài đặt lại nó thủ công bằng cách gọi volta install pnpm. Trước khi bật hỗ trợ và thực hiện cài đặt lại, bạn có thể gỡ cài đặt gói pnpm previously đã cài đặt thông qua volta uninstall pnpm. Một khi bạn chuyển sang hỗ trợ pnpm gốc, bạn có thể không xóa gói pnpm cũ biệt lập bằng cách gọi cùng một lệnh vì thiếu triển khai gỡ cài đặt cho đến nay.

Bật hỗ trợ pnpm

Trên Unix (Linux/macOS)

Thêm dòng sau vào hồ sơ shell của bạn (.bashrc, .zshrc, v.v.):

export VOLTA_FEATURE_PNPM=1

Sau đó tải lại shell của bạn hoặc chạy:

source ~/.bashrc  # hoặc file hồ sơ cụ thể của bạn

Trên Windows

1. Mở menu Start và tìm kiếm "Environment Variables" (Biến Môi trường)
2. Nhấp vào "Edit the system environment variables" (Chỉnh sửa biến môi trường hệ thống)
3. Trong cửa sổ System Properties, nhấp vào "Environment Variables" (Biến Môi trường)
4. Dưới "User variables" (Biến người dùng), nhấp "New" (Mới)
5. Nhập "VOLTA_FEATURE_PNPM" làm tên biến và "1" làm giá trị
6. Nhấp "OK" để đóng tất cả các hộp thoại

Sử dụng pnpm với Volta

Sau khi bạn đã bật hỗ trợ pnpm, bạn có thể:

1. Cài đặt pnpm làm trình quản lý gói mặc định của bạn:

volta install pnpm

2. Ghim một phiên bản pnpm cụ thể trong một dự án:

volta pin pnpm@7.14.0

3. Xem các phiên bản pnpm đã cài đặt:

volta list pnpm

Khắc phục sự cố

Nếu bạn gặp vấn đề với pnpm trong Volta:

1. Xác minh cờ tính năng được đặt chính xác:

   • Trên Unix: echo $VOLTA_FEATURE_PNPM
   • Trên Windows: echo %VOLTA_FEATURE_PNPM%

2. Kiểm tra xem pnpm được cài đặt đúng cách:

   • Chạy volta list để xem pnpm có xuất hiện trong danh sách không

3. Đối với bất kỳ vấn đề nào khác, vui lòng báo cáo chúng trên kho Volta GitHub.