🧶 فرمت‌دهنده Yarn.lock – پاکسازی و نرمال‌سازی فایل‌های قفل Yarn (نسخه‌های ۱ تا ۴)

Loading…

درباره این فرمت‌دهنده Yarn فرمت‌دهنده آنلاین Yarn.lock

فایل yarn.lock خود را در ویرایشگر قرار دهید یا محتوای آن را پیست کرده و روی **فرمت** کلیک کنید. در پشت صحنه، این ابزار از یک سرویس پشتیبان امن استفاده می‌کند که با تجزیه‌کننده‌های رسمی فایل قفل Yarn (نسخه‌های ۱ تا ۴)، فایل قفل شما را در قالبی استاندارد و پایدار بازنویسی می‌کند – با حفظ نسخه‌ها، هش‌های یکپارچگی و فراداده‌ها، در حالی که تورفتگی‌ها و ترتیب را مرتب می‌سازد.

این فرمت‌دهنده Yarn.lock چه کاری برای شما انجام می‌دهد

از تجزیه‌کننده‌های آگاه از Yarn برای بازنویسی ایمن فایل‌های yarn.lock از نسخه‌های ۱ تا ۴ (کلاسیک و Berry/مدرن) استفاده می‌کند
فاصله‌گذاری، فاصله‌ها و ترتیب بلوک‌ها را نرمال می‌کند تا تفاوت‌های پرسر و صدای Git کاهش یابد
نسخه‌ها، آدرس‌های حل‌شده، هش‌های یکپارچگی و فراداده را دقیقاً به همان شکل حفظ می‌کند
مستقیماً روی محتوای yarn.lock کار می‌کند (نیازی به اجرای yarn install فقط برای مرتب‌سازی قالب‌بندی نیست)
پشتیبانی از کشیدن و رها کردن برای فایل‌های .lock با پیش‌نمایش برجسته‌سازی نحوی
ساختار فایل قفل را اعتبارسنجی می‌کند و خطاهای تجزیه را نشان می‌دهد به جای اینکه داده‌ها را به صورت خاموش خراب کند
از یک نقطه پایانی قالب‌بند سمت سرور امن استفاده می‌کند، با محدودیت‌های سخت اندازه و زمان‌بندی برای ایمنی

🛠️ چگونه یک فایل Yarn.lock را به صورت آنلاین نرمال کنیم for yarn-formatter

۱. چسباندن یا آپلود yarn.lock

فایل **yarn.lock** پروژه خود را باز کنید، محتوای آن را در ویرایشگر کپی کنید یا فایل را بکشید و رها کنید. این ابزار فایل‌های قفل Yarn از نسخه ۱ تا ۴ را تشخیص می‌دهد.

۲. اجرای قالب‌بند

دکمه **Format** را کلیک کنید. بک‌اند فایل قفل شما را با منطق آگاه از Yarn تجزیه می‌کند و آن را به شکل استاندارد و نرمال شده بازتولید می‌کند.

۳. بررسی خروجی

yarn.lock قالب‌بندی شده را بررسی کنید. نسخه‌ها، آدرس‌های حل‌شده، هش‌های یکپارچگی و فراداده باید یکسان باشند—فقط فاصله‌های سفید و ترتیب مرتب شده‌اند.

۴. کپی یا دانلود و کامیت

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

جزئیات فنی

پشتیبانی از Yarn.lock و نسخه

این ابزار منحصراً بر روی فایل‌های قفل Yarn تمرکز دارد و هر دو قالب فایل قفل کلاسیک و مدرن را درک می‌کند.

نوع فایل قفل	پشتیبانی	یادداشت‌ها
Yarn v1 (کلاسیک)	✅ کامل	از قالب فایل قفل اصلی کلید/مقدار با نظرات هدر پشتیبانی می‌کند.
Yarn v2–v4 (Berry/مدرن)	✅ کامل	طرح فایل قفل به سبک YAML جدیدتر و بلوک‌های فراداده را درک می‌کند.
فایل‌های .lock غیر Yarn	⚠️ تضمین شده نیست	سایر قالب‌های قفل (npm، pnpm و غیره) به طور رسمی توسط این قالب‌بند پشتیبانی نمی‌شوند.
package.json	❌ خارج از محدوده	به جای آن از ابزار فرمت‌کننده JSON برای قالب‌بندی package.json استفاده کنید.

رفتار قالب‌بندی

فرمت‌کننده هدفش **ایمن و یکسان‌ساز** است: اجرای مکرر آن باید فایل قفل شما را پایدار نگه دارد در حالی که هرگز معنای وابستگی‌ها را تغییر نمی‌دهد.

جنبه	رفتار	تأثیر
نظرات سربرگ	دست‌نخورده حفظ می‌شود	هشدار فایل تولید خودکار استاندارد و فراداده را دست‌نخورده نگه می‌دارد.
ورودی‌های وابستگی	چاپ مجدد از طریق چاپگرهای آگاه از Yarn	فاصله‌گذاری و ترتیب را بدون تغییر نسخه‌ها پایدار می‌کند.
فضای خالی و تورفتگی	نرمال‌شده	فاصله‌گذاری ناسازگار را حذف می‌کند، تورفتگی را هم‌تراز می‌کند و خطوط خالی را استاندارد می‌سازد.
ترتیب فیلدها	استاندارد بر اساس قوانین Yarn	با حفظ ترتیب ثابت کلیدها، تفاوت‌های ناخواسته را کاهش می‌دهد.
تماس‌های شبکه	هیچ	فرمت‌کننده به مخازن دسترسی نداشته و درخت node_modules شما را تغییر نمی‌دهد.

محدودیت‌ها، عملکرد و ایمنی

طراحی شده برای استفاده سریع و تعاملی با فایل‌های قفل واقعی در حالی که از سرور و مرورگر شما محافظت می‌کند.

پارامتر	مقدار	یادداشت‌ها
حداکثر اندازه متن	≈ ۲,۰۰۰,۰۰۰ نویسه	محدودیت ایمنی سخت قبل از فراخوانی نقطه پایانی فرمت‌کننده اعمال می‌شود.
حداکثر اندازه فایل	~۵ مگابایت	محدودیت سطح رابط کاربری برای آپلودها برای جلوگیری از موارد شدید.
زمان‌سنج	~۲۵ ثانیه	درخواست‌هایی که بیش از حد طول می‌کشند با پیام خطای واضحی قطع می‌شوند.
محل پردازش	سمت سرور	قالب‌بندی در یک بک‌اند امن با استفاده از منطق آگاه از Yarn اجرا می‌شود.
پایداری	بدون ذخیره‌سازی بلندمدت	محتوای فایل قفل به صورت موقت پردازش می‌شوند تا نتیجه قالب‌بندی شده محاسبه شود.

جایگزین‌های CLI برای پاکسازی Yarn.lock

برای مخازن بزرگ یا گردش‌های کاری خودکار، معمولاً بهتر است نرمال‌سازی فایل قفل را در زنجیره ابزار موجود Yarn/Node.js خود نگه دارید.

لینوکس / 🍏 مک‌اواس / 🪟 ویندوز (Node.js)

ایجاد مجدد yarn.lock از ابتدا

rm yarn.lock && yarn install

به Yarn اجازه می‌دهد فایل قفل را بر اساس package.json و وضعیت فعلی رجیستری مجدداً تولید کند.

قالب‌بندی فایل‌های قفل و مانیفست‌های JSON با Prettier

npx prettier "**/yarn.lock" "**/package.json" --write

از Prettier برای نرمال‌سازی فاصله‌های سفید در فایل‌های قفل و مانیفست‌های پکیج استفاده می‌کند.

مرتب‌سازی فیلدهای package.json برای diffهای کوچک‌تر

npx sort-package-json

بخش‌های package.json مانند وابستگی‌ها و اسکریپت‌ها را به صورت یکنواخت مرتب نگه می‌دارد.

از این فرمت‌کننده آنلاین برای پاکسازی‌های دستی سریع یا بررسی‌ها استفاده کنید و Yarn/Prettier را به خط لوله CI خود متصل کنید برای نرمال‌سازی کاملاً خودکار.

موارد استفاده عملی

پاکسازی تفاوت‌های پرسر و صدای Git

کاهش نویز مرتبط با فایل قفل در درخواست‌های pull.

نرمال‌سازی yarn.lock پس از ادغام‌های پیچیده که فاصله‌گذاری و ترتیب ناسازگار شده‌اند.
اجرای فرمت‌کننده قبل از باز کردن PR برای تسهیل بررسی تغییرات وابستگی.
تثبیت قالب‌بندی فایل قفل تا تفاوت‌های آینده بر تغییرات نسخه واقعی متمرکز شوند.

پروژه‌های Monorepo و چند شاخه‌ای

فایل‌های قفل را در بین تیم‌ها و شاخه‌ها قابل خواندن و پایدار نگه دارید.

هم‌ترازی قالب‌بندی فایل قفل پس از rebase شاخه یا شاخه‌های feature طولانی‌مدت.
نرمال‌سازی فایل‌های قفل تولید شده توسط Yarn v1 قدیمی هنگام مهاجرت به گردش‌های کاری مدرن‌تر.
استفاده از ابزار به عنوان کمک تشخیصی هنگامی که تعارضات فایل قفل مدام تکرار می‌شوند.

آموزش و ورود به تیم

کمک به تازه‌واردان برای درک عملکرد yarn.lock بدون سردرگمی با خروجی آشفته.

نمایش فایل‌های قفل قبل/بعد برای نشان دادن چگونگی ردیابی درخت وابستگی دقیق توسط Yarn.
استفاده از فایل‌های قفل نرمال‌شده در مستندات و کارگاه‌ها به جای نمونه‌های خام و پرسر و صدا.
نشان دادن دلیل commit و بررسی فایل‌های قفل مانند هر فایل منبع دیگر.

❓ Frequently Asked Questions

🧾با این ابزار چه فایل‌هایی را می‌توانم قالب‌بندی کنم؟

این فرمت‌کننده مخصوص **فایل‌های قفل Yarn** است، که معمولاً `yarn.lock` نامیده می‌شوند. این ابزار فایل‌های قفل تولید شده توسط Yarn v1 (کلاسیک) و Yarn v2–v4 (مدرن/Berry) را درک می‌کند. برای `package.json`، به جای آن از یک فرمت‌کننده JSON استفاده کنید.

🧠آیا فرمت‌کننده وابستگی‌های من را تغییر می‌دهد؟

خیر. هدف **نرمال‌سازی قالب‌بندی، نه معنا** است. نسخه‌ها، URLهای حل شده، هش‌های integrity و روابط وابستگی دقیقاً یکسان باقی می‌مانند. فقط فاصله‌های سفید، ترتیب و چیدمان پاکسازی می‌شوند.

🔐آیا استفاده از این ابزار برای پروژه‌های خصوصی ایمن است؟

قالب‌بندی در یک نقطه پایانی امن سمت سرور با محدودیت‌های سخت اندازه و زمان اجرا می‌شود. محتوای فایل قفل به صورت موقت پردازش می‌شود تا نتیجه محاسبه شود و به صورت بلندمدت ذخیره نمی‌شود. با این حال، برای پایگاه‌های کد بسیار حساس یا تحت مقررات، ممکن است ترجیح دهید Yarn و ابزارهای مرتبط را کاملاً در زیرساخت خودتان اجرا کنید.

⚙️آیا می‌توانم package.json را نیز اینجا قالب‌بندی کنم؟

این ابزار خاص روی `yarn.lock` متمرکز است. برای قالب‌بندی `package.json`، از یک قالب‌بند JSON اختصاصی یا Prettier با `"**/package.json" --write` استفاده کنید. هم‌تراز نگه داشتن قالب‌بندی فایل قفل و مانیفست روشی عالی برای کاهش نویز diff است.

🚫اگر yarn.lock من خراب باشد یا فایل Yarn نباشد چه اتفاقی می‌افتد؟

اگر تجزیه‌گر آگاه از Yarn نتواند فایل را به عنوان یک فایل قفل معتبر تشخیص دهد، ابزار به جای حدس زدن، خطا برمی‌گرداند. در آن صورت، فایل قفل را با Yarn دوباره تولید کنید (مثلاً با اجرای `yarn install`) و دوباره امتحان کنید.

🔁آیا قالب‌بند idempotent است؟

بله. اجرای مکرر قالب‌بند روی یک yarn.lock یکسان باید خروجی یکسانی تولید کند که برای خطوط لوله CI و هوک‌های pre-commit ایده‌آل است.

Pro Tips

Best Practice

yarn.lock را قبل از باز کردن درخواست‌های pull نرمال کنید تا بازبین‌ها بتوانند روی تغییرات واقعی نسخه به جای نویز فاصله‌های سفید تمرکز کنند.

CI Tip

این قالب‌بند آنلاین را با یک هوک pre-commit یا مرحله CI که Yarn یا Prettier را روی فایل‌های قفل اجرا می‌کند جفت کنید تا یکپارچگی end-to-end داشته باشید.

Best Practice

هنگام اشکال‌زدایی مشکلات وابستگی، از یک فایل قفل تمیز در گزارش‌های مشکل خود استفاده کنید تا برای نگهدارندگان اسکن کردن آن آسان‌تر شود.

Best Practice

اگر یک فایل قفل مشکوک به نظر می‌رسد (نشانگرهای تضاد ادغام، محتوای جزئی)، قبل از قالب‌بندی آن را با Yarn دوباره تولید کنید تا از پنهان کردن مشکلات عمیق‌تر جلوگیری کنید.