Yarn 1.x: package manager JavaScript đã đóng băng
Yarn 1.x từng giải quyết đúng nỗi đau quản lý package của npm hồi 2016: cài đặt deterministic, cache offline, checksum cho từng package. Dòng 1.x giờ đã đóng băng. README nói rõ chỉ nhận vá bảo mật, còn phát triển thật sự chuyển hết sang Yarn Berry. Bắt đầu dự án mới bằng Yarn 1.x hôm nay nghĩa là chọn một package manager vốn đã biết mình là hàng cũ.
The package management problems Yarn 1.x was built to solve
Năm 2016, cài package bằng npm chậm, không deterministic - cùng một package.json có thể ra kết quả khác nhau trên hai máy - và chạy thẳng code của package mà không kiểm tra tính toàn vẹn file trước. Yarn 1.x giải quyết việc đó bằng thuật toán cài đặt deterministic dựa trên lockfile, cache package cục bộ để cài offline, và xác minh checksum trước khi code được thực thi.
Yarn 1.x là gì?
Yarn 1.x là một dependency manager cho JavaScript, cài các package được khai báo trong package.json của dự án, dùng file yarn.lock để ghim đúng phiên bản trên mọi máy chạy lệnh cài đặt. Hiện tại nó được giữ lại chủ yếu vì lý do lịch sử: README ghi rõ dòng 1.x đã đóng băng, còn bản phát hành mới và các bugfix được theo dõi ở repo yarnpkg/berry riêng.
Tính năng chính
- ✓Offline mode: một khi package đã được tải về, Yarn 1.x có thể cài lại nó mà không cần kết nối mạng.
- ✓Cài đặt deterministic: lockfile cộng với thuật toán cài đặt cố định nghĩa là cùng một package.json sẽ ra kết quả giống nhau trên mọi máy, bất kể thứ tự cài.
- ✓Xác minh checksum: tính toàn vẹn của mỗi package được kiểm tra trước khi code của nó chạy.
- ✓Request mạng được xếp hàng và chạy đồng thời nhằm tránh request waterfall, cộng với tự động retry để một request lỗi không làm hỏng cả lượt cài.
- ✓Flat mode, gom các phiên bản dependency bị lệch nhau về một phiên bản duy nhất để giảm trùng lặp.
- ✓Định dạng file yarn.lock mà README mô tả là chi tiết nhưng gọn.
Điểm mạnh
- ✓Cài đặt deterministic là một bước tiến thật sự so với npm thời kỳ đầu, và vẫn đúng với các dự án đang dùng Yarn 1.x.
- ✓Cache offline giúp các lần cài lại nhanh và ít bị ảnh hưởng bởi kết nối mạng kém.
- ✓Xác minh checksum trước khi code chạy là một lớp kiểm tra toàn vẹn thật sự mà nhiều package manager thời đó chưa có.
- ✓Request mạng được xếp hàng và tự động retry, nên một request lỗi không làm sập cả quá trình cài.
Vì sao Yarn 1.x đã đóng băng và điều đó có nghĩa gì với bạn
- △Dòng 1.x đã đóng băng: theo README, chỉ các bản vá bảo mật được chấp nhận, còn mọi tính năng mới và bugfix đều chuyển sang yarnpkg/berry.
- △Chính README khuyên migrate khỏi Yarn 1.x để nhận được các bản vá tiếp theo, nên đây không phải lựa chọn tốt cho một dự án hoàn toàn mới.
- △Thông tin license không xuất hiện trong metadata công khai của repository, nên các team có yêu cầu tuân thủ license cần tự kiểm tra file LICENSE thay vì giả định.
- △Hướng dẫn cài đặt và sử dụng nằm hoàn toàn trên một website bên ngoài chứ không phải trong README, nên không có gì để tham khảo nếu chỉ ở lại GitHub.
Lựa chọn thay thế: npm, pnpm và Yarn Berry
Câu hỏi thường gặp về Yarn 1.x
Yarn 1.x không còn được phát triển tính năng mới - README nói rõ dòng 1.x đã đóng băng và chỉ nhận vá bảo mật. Việc phát triển, phát hành bản mới, và sửa lỗi nói chung diễn ra ở repo yarnpkg/berry riêng, nên Yarn 1.x đang ở trạng thái chỉ bảo trì tối thiểu hơn là bị deprecated hoàn toàn.
Repository yarnpkg/yarn không hiển thị rõ một license cụ thể trong metadata công khai. Ai có yêu cầu tuân thủ license nên mở trực tiếp file LICENSE trong repository yarnpkg/yarn trên GitHub để xác nhận điều khoản hiện tại, thay vì giả định.
README của Yarn 1.x dẫn tới một migration guide chính thức trên website Yarn (yarnpkg.com/getting-started/migration) thay vì ghi các bước ngay trong repo. Yarn Berry còn có setting nodeLinker cho phép chọn cách cài package: node_modules kiểu npm, symlink kiểu pnpm, hoặc manifest file qua Yarn PnP.
Yarn 1.x hỗ trợ cài offline qua Offline Mode: một khi package đã được tải về, Yarn cache nó cục bộ, nên cài lại đúng package đó vẫn chạy được mà không cần kết nối mạng.
Yarn 1.x được xây quanh một thuật toán cài đặt deterministic và định dạng lockfile để cùng một package.json cài ra kết quả giống nhau trên mọi máy, cộng với cache offline cục bộ và xác minh checksum trước khi code package chạy. npm sau này cũng có lockfile riêng, package-lock.json, với mục tiêu deterministic tương tự, thu hẹp khoảng cách ban đầu giữa hai bên.
Yarn 1.x dùng checksum: trước khi code của một package đã tải về được phép chạy, Yarn kiểm tra checksum của nó so với giá trị đã ghi lại, nên một bản tải bị hỏng hoặc bị can thiệp sẽ bị phát hiện trước khi chạy.
Trường hợp sử dụng phù hợp nhất
- •Giữ cho việc cài đặt của một dự án Yarn 1.x sẵn có luôn tái lập được giữa CI và máy của từng developer, nhờ yarn.lock.
- •Cài dependency khi mạng chập chờn hoặc mất kết nối, nhờ cache package cục bộ.
- •Duy trì các dự án Node.js cũ đã xây trên Yarn 1.x mà chưa được migrate.
- •So sánh cách cài đặt deterministic dựa trên lockfile của Yarn với cách tiếp cận lockfile của npm trước khi chuẩn hoá tooling.
Cách cài đặt / dùng thử
README của yarnpkg/yarn không có sẵn lệnh cài đặt cụ thể - nó dẫn tới một Installation Guide trên website của Yarn thay vì liệt kê các bước ngay trong repo, nên các bước cụ thể không được ghi rõ trong repository.
Cách sử dụng
Tương tự phần cài đặt: README dẫn tới một Usage Guide trên website của Yarn thay vì ghi trực tiếp các lệnh CLI trong repo, nên cách dùng cụ thể không được ghi rõ trong repository.
Ai nên dùng thử - và ai nên bỏ qua
Những team đang chạy sẵn một dự án Yarn 1.x với yarn.lock hoạt động ổn và chưa có lý do cấp bách để đụng vào tooling thì có thể cứ để nguyên - nó vẫn cài đặt deterministic và cache offline vẫn chạy tốt. Còn ai đang bắt đầu dự án mới, hoặc đang gặp đúng những vấn đề mà README nói Berry đã xử lý, nên coi dòng 1.x đã đóng băng này là giải pháp tạm và chuyển sang bản mới.
Repo liên quan
Muốn nghe thêm một ý kiến về yarn?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về yarn.
