چگونه Yarn Package Manager را برای Node.js نصب و استفاده کنیم؟

اگر با Node.js کار کرده باشید، احتمالا نام Yarn را شنیده‌اید؛ ابزاری که به عنوان یک مدیر بسته سریع، ایمن و قابل اعتماد شناخته می‌شود. Yarn در ابتدا برای رفع محدودیت‌های NPM معرفی شد و به مرور زمان به یکی از ابزارهای محبوب در بین توسعه‌دهندگان، برنامه‌نویسان React، تبدیل شد.

قابلیت‌هایی مانند کش داخلی برای هر پروژه، نصب‌های پایدار و یکپارچه، تست صحت بسته‌ها و پشتیبانی از Workspaces، آن را به انتخاب حرفه‌ای برای مدیریت وابستگی‌ها در پروژه‌های Node.js تبدیل کرده است. در این راهنما با مراحل نصب Yarn و استفاده از دستورات پایه‌ای آن آشنا می‌شویم.

در ادامه خواهید خواند:

• پیش نیاز
• مرحله 1: نصب Yarn به صورت سراسری (Globally)
• مرحله 2: نصب Yarn در پروژه
• استفاده از Yarn
• سوالات متداول
• جمع بندی

پیش نیاز

قبل از اینکه Yarn را نصب و استفاده کنید، باید مطمئن شوید که Node.js روی سیستم شما نصب است.

برای بررسی این موضوع، در ترمینال دستور زیر را اجرا کنید:

node -v

• اگر یک نسخه مانند v12.16.3 نمایش داده شد، یعنی Node.js نصب است.
• اگر با خطایی مثل command not found مواجه شدید، باید ابتدا Node.js را نصب کنید.

برای نصب Node.js، کافی است متناسب با سیستم عامل خود دستورالعمل نصب آن را دنبال کنید. وقتی Node.js نصب شد، می‌توانید به مرحله 1 بروید و Yarn را روی سیستم خود نصب کنید.

این آموزش برای نسخه‌های جدید اوبنتو یعنی Ubuntu 24.04, Ubuntu 22.04 و Ubuntu 20.04 معتبر است. اگر از نسخه‌های قدیمی‌تر استفاده می‌کنید، پیشنهاد می‌شود اوبونتوی خود را به نسخه‌های جدید ارتقا دهید، زیرا نسخه‌های قدیمی دیگر پشتیبانی نمی‌شوند.

مرحله 1: نصب Yarn به صورت سراسری (Globally)

Yarn روش خاصی برای نصب و اجرا در پروژه‌های جاوااسکریپتی دارد. ابتدا باید دستور  yarn  را به‌صورت سراسری روی سیستم نصب کنید. سپس همین دستور سراسری را می‌توانید برای نصب یک نسخه محلی از Yarn داخل پروژه خود استفاده کنید. این کار باعث می‌شود همه افرادی که روی پروژه کار می‌کنند (و حتی ابزارهای تست و استقرار خودکار پروژه) از یک نسخه یکسان Yarn استفاده کنند تا از بروز ناسازگاری جلوگیری شود.

توسعه‌‌‌دهندگان Yarn پیشنهاد می‌کنند که Yarn را به کمک NPM به شکل سراسری نصب کنید. برای این کار از فلگ -g استفاده کنید.

sudo npm install -g yarn

بعد از نصب، می‌توانید با دستور زیر نسخه Yarn نصب‌شده را بررسی کنید تا مطمئن شوید درست نصب شده است:

yarn --version

خروجی نمونه:

Output
1.22.22

حالا که دستور Yarn به‌صورت سراسری روی سیستم شما نصب شد، می‌توانید از آن برای نصب Yarn در یک پروژه جاوااسکریپتی مشخص استفاده کنید.

مرحله 2: نصب Yarn در پروژه

اگر در حال کار روی یک پروژه‌ای هستید که از قبل با Yarn راه‌اندازی شده، می‌توانید از این مرحله عبور کنید. چون چنین پروژه‌ای معمولا یک نسخه محلی از Yarn و فایل‌های تنظیمات لازم را دارد.

اما اگر در حال ساخت یک پروژه جدید هستید، باید یک نسخه مخصوص همان پروژه از Yarn را تنظیم کنید.

ابتدا وارد پوشه پروژه خود شوید:

cd ~/my-project

اگر هنوز پوشه‌ای برای پروژه ندارید، می‌توانید با دستور زیر یک پوشه بسازید و وارد آن شوید:

mkdir my-project
cd my-project

حالا با دستور زیر نسخه Yarn را روی حالت berry تنظیم کنید:

yarn set version berry

این دستور نسخه فعال و در حال توسعه‌ی Yarn یعنی berry را دانلود کرده و آن را داخل مسیر .yarn/releases/ ذخیره می‌کند. همچنین یک فایل پیکربندی به نام .yarnrc.yml برای پروژه می‌سازد.

خروجی نمونه:

Output
Resolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/sammy/my-project/.yarn/releases/yarn-berry.cjs...
Updating /home/sammy/my-project/.yarnrc.yml...
Done!

حالا دوباره دستور زیر را اجرا کنید تا نسخه Yarn نصب شده در پروژه را ببینید:

yarn --version

خروجی نمونه:

Output
4.5.0

می‌بینید که نسخه نمایش داده شده 3.0.0 یا بالاتر است که نشان‌دهنده جدیدترین نسخه Yarn می‌باشد.

نکته: اگر از پوشه پروژه خارج شوید و دوباره دستور yarn --version را بزنید، نسخه سراسری را اجرا می‌کند و فقط وقتی داخل پوشه‌ای باشید که فایل .yarnrc.yml دارد، نسخه محلی همان پروژه را اجرا می‌کند.

اکنون پروژه شما با یک نسخه محلی از Yarn راه‌اندازی شده است. در ادامه با چند دستور پرکاربرد Yarn برای شروع کار آشنا می‌شویم.

استفاده از Yarn

Yarn دستورهای زیادی دارد، اما برای شروع تنها به چند دستور اصلی نیاز دارید، در ادامه با مهم‌ترین آن‌ها آشنا می‌شویم:

دریافت راهنمایی

برای هر ابزار جدیدی، خوب است بدانید چگونه به راهنمای آنلاین آن دسترسی پیدا کنید. در Yarn می‌توانید از فلگ --help استفاده کنید:

yarn --help

این دستور راهنمای کلی Yarn را نمایش می‌دهد. اگر بخواهید اطلاعات دقیق‌تر درباره یک زیر دستور (Subcommand) خاص ببینید، کافی است --help را بعد از آن زیر دستور اضافه کنید:

yarn install --help

این دستور جزئیات استفاده از دستور install را نمایش می‌دهد.

شروع یک پروژه جدید با Yarn

اگر می‌خواهید پروژه‌ای از صفر بسازید، از دستور init استفاده کنید:

yarn init

این دستور دو فایل مهم را به پروژه شما اضافه می‌کند:

• package.json: شامل تنظیمات پروژه و لیست وابستگی‌ها
• yarn.lock: نسخه‌های دقیق وابستگی‌ها را قفل می‌کند تا همیشه یک ساختار ثابت داشته باشید

نصب همه وابستگی‌های پروژه

برای دانلود و نصب همه وابستگی‌ها در یک پروژه موجود که از Yarn استفاده می‌کند، از دستور install استفاده کنید:

yarn install

این دستور همه ماژول‌های مورد نیاز برای شروع پروژه را دانلود و نصب می‌کند.

افزودن وابستگی جدید به پروژه

برای اضافه کردن یک پکیج جدید به پروژه، از دستور add استفاده کنید:

yarn add package-name

این دستور پکیج را دانلود و نصب می‌کند و فایل‌های package.json و yarn.lock را به‌روزرسانی می‌کند.

به‌روزرسانی فایل .gitignore برای Yarn

Yarn فایل‌هایی را در پوشه .yarn داخل پروژه ذخیره می‌کند. برخی از این فایل‌ها باید وارد کنترل نسخه شوند و برخی باید نادیده گرفته شوند. یک پیکربندی پایه .gitignore برای Yarn به شکل زیر است:

.gitignore
.yarn/*
!.yarn/patches
!.yarn/plugins
!.yarn/releases
!.yarn/sdks
!.yarn/versions
.pnp.*

این پیکربندی، کل پوشه .yarn را نادیده می‌گیرد استثناهایی برای پوشه‌های مهم مثل releases که شامل نسخه محلی Yarn پروژه است، در نظر می‌گیرد.

سوالات متداول

Yarn چیست و چه تفاوتی با NPM دارد؟

Yarn یک مدیر بسته برای Node.js است که روی سرعت، امنیت و پایداری تمرکز دارد. تفاوت اصلی آن با NPM در سرعت بالاتر نصب، مدیریت بهتر کش، و نصب‌های قابل‌پیش‌بینی است.

آیا قبل از نصب Yarn باید Node.js نصب باشد؟

بله. Yarn برای اجرا به Node.js نیاز دارد. اگر Node.js روی سیستم شما نصب نباشد، باید ابتدا آن را نصب کنید.

تفاوت بین نصب سراسری (Global) و محلی (Project-specific) در Yarn چیست؟

نصب سراسری باعث می‌شود دستور yarn در همه پروژه‌ها در دسترس باشد، اما نصب محلی نسخه‌ای از Yarn را مخصوص همان پروژه تنظیم می‌کند تا همه اعضای تیم از نسخه یکسانی استفاده کنند.

چطور می‌توانم یک پکیج جدید را با Yarn نصب کنم؟

برای افزودن یک پکیج جدید کافی است دستور زیر را اجرا کنید:

yarn add package-name

Yarn پکیج را نصب کرده و فایل‌های package.json و yarn.lock را به‌روزرسانی می‌کند.

فایل yarn.lock چیست و چرا مهم است؟

فایل yarn.lock نسخه دقیق همه پکیج‌های نصب‌شده را ذخیره می‌کند تا هر بار که پروژه نصب می‌شود، دقیقا همان نسخه‌ها نصب شوند و از بروز ناسازگاری جلوگیری شود.

جمع بندی

Yarn یک ابزار قدرتمند برای مدیریت بسته‌های Node.js است که با تمرکز بر سرعت، امنیت و پایداری، تجربه‌ای بهتر از NPM ارائه می‌دهد. این ابزار با قابلیت‌هایی مثل کش هوشمند، نصب سریع و کنترل دقیق نسخه‌ها، روند توسعه را ساده‌تر و قابل اعتمادتر می‌کند.

همچنین Yarn با پشتیبانی از ساختارهایی مانند Workspaces، مدیریت پروژه‌های چندبخشی را آسان کرده و از بروز ناسازگاری در وابستگی‌ها جلوگیری می‌کند. به همین دلیل، بسیاری از توسعه‌دهندگان آن را به‌عنوان گزینه‌ای کارآمد و حرفه‌ای برای پروژه‌های خود انتخاب می‌کنند.