وقتی چیزی درست کار نمی‌کند

پیامی را که گرفته‌اید پایین‌تر پیدا کنید (کلید `/` را بزنید و چند کلمه از آن را بنویسید)، یا موقعیتی را که در آن هستید. پیام‌های zev انگلیسی‌اند، پس عنوان‌ها هم همان متن انگلیسی‌اند. ## پیام‌های zev ### "Not a zev repository" دستوری را بیرون از یک پروژه اجرا کرده‌اید. با `cd` به پوشهٔ پروژه بروید (همانی که پوشهٔ پنهان `.zev` دارد)، یا با `zev init` پوشهٔ فعلی را پروژه کنید. ### "Nothing to commit (staging area is empty)" چیزی مرحله‌بندی نکرده‌اید. اول تغییرات را مرحله‌بندی کنید: ```bash zev add . zev commit -m "پیام" ``` ### "Nothing new to add: no changes since the last commit" فایل‌هایی که نام بردید دقیقاً مثل آخرین کامیت هستند، پس چیزی برای مرحله‌بندی نیست. با `zev status` ببینید واقعاً چه چیزی تغییر کرده. ### "'file' doesn't exist, and zev doesn't track it" مسیر اشتباه است (املا و پوشه‌ای را که در آن هستید بررسی کنید)، یا فایل هرگز کامیت نشده و چیزی برای مرحله‌بندی نیست. ### "'file' is ignored (it matches a pattern in .zevignore)" یک خط در `.zevignore` با این فایل جور است. اگر باید ردیابی شود، آن خط را حذف یا اصلاح کنید. ### "Not switching to 'branch': you have local changes" جابه‌جایی، تغییرات کامیت‌نشده‌تان را بازنویسی می‌کرد و zev هرگز بی‌صدا این کار را نمی‌کند. یکی را انتخاب کنید: ```bash zev commit -m "کار نیمه‌تمام" # نگهشان دارید، روی همین شاخه zev stash # نگهشان دارید، کنار (بعداً zev stash pop) zev checkout --force branch # دورشان بریزید ``` ### "Working files NOT updated" `zev pull` کامیت‌های تازه را گرفت اما فایل‌هایتان را تغییر نداد، چون فایلی که تغییر داده‌اید بازنویسی می‌شد. چیزی از دست نرفته. تغییراتتان را کامیت یا stash کنید، بعد: ```bash zev checkout <your-branch> ``` ### "Can't bring 'branch' in automatically: … changed the same lines" تعارض ادغام: هر دو شاخه همان خط‌ها را تغییر داده‌اند. `zev merge <branch> --resolve` را بزنید و [وقتی هر دو طرف همان خط‌ها را تغییر داده‌اند](/docs/fa/branches#وقتی-هر-دو-طرف-همان-خطها-را-تغییر-دادهاند) را دنبال کنید. ### "has changes that aren't committed. Nothing was removed." `zev rm` فایلی را که تغییرات کامیت‌نشده دارد حذف نمی‌کند. اول کامیتشان کنید، یا با `zev rm --cached` ردیابی را متوقف کنید و فایل را نگه دارید، یا با `zev rm --force` به هر حال حذفش کنید. ### "Not applying stash: 'file' has changes of its own" پس از stash فایلی را تغییر داده‌اید و stash آن را بازنویسی می‌کرد. آن تغییرات تازه‌تر را کامیت یا stash کنید و دوباره `zev stash pop` بزنید. ### "No remote named 'origin'" پروژه هنوز به Zaryn وصل نیست. یا آنجا بسازیدش: ```bash zev new ``` یا به مخزنی که وجود دارد وصلش کنید: ```bash zev remote add origin owner/project ``` ### "Challenge request failed" هنگام ورود هویت این پروژه هنوز روی سرور حساب ندارد. با `--register` و `--email` حساب بسازید، یا اگر حسابتان را در وب‌سایت ساخته‌اید با `zev login zaryn.xyz --device` وارد شوید. ### "Could not reach …" zev نتوانست به سرور وصل شود. نشانی را بررسی کنید (برای Zaryn همان `zaryn.xyz` کافی است)، همین‌طور اتصال اینترنت و هر پراکسی یا فایروالی را. ### HTTP 401 یا "unauthorized" وارد نشده‌اید، یا توکنتان باطل یا منقضی شده. با `zev whoami` بررسی کنید و دوباره `zev login` بزنید. ### HTTP 403 یا "forbidden" وارد شده‌اید، اما حسابتان اینجا اجازهٔ این کار را ندارد؛ مثلاً push به مخزن کس دیگری. از مالک بخواهید شما را اضافه کند، یا [فورکش کنید](/docs/fa/how-do-i#مشارکت-در-پروژهای-که-نمیتوانم-در-آن-push-کنم). ### HTTP 402 این کار به Premium یا اعتبار بیشتر نیاز دارد (شبکه‌های خصوصی، بعضی ابزارهای پیشرفته). [پرداخت و اعتبار Zaryn](/docs/fa/billing-and-credits) را ببینید. ### HTTP 413 یا "quota" push از حدی که طرحتان اجازه می‌دهد بزرگ‌تر است (اندازهٔ مخزن یا فایل). فایل‌های بزرگ ساخته‌شده را از کامیت بیرون بیاورید، نادیده‌شان بگیرید، یا طرحتان را ارتقا دهید. ### "Unknown command" غلط تایپی، یا دستوری از git که zev نام دیگری برایش دارد. zev نزدیک‌ترین دستور را پیشنهاد می‌کند. چند نمونهٔ رایج: | git | zev | |---|---| | `git reset <file>` | `zev restore --staged <file>` | | `git checkout -- <file>` | `zev restore <file>` | | `git switch -c <branch>` | `zev switch -c <branch>` (یا `zev checkout -b`) | | `git fetch` + `git merge` | `zev pull` | | `git mv a b` | فایل را تغییر نام دهید، بعد `zev add a b` | ## موقعیت‌ها ### چیزی را کامیت کردم که نباید می‌کردم اگر push نکرده‌اید: فایل‌ها را درست کنید و کامیت دیگری بسازید (zev کامیت‌ها را بازنویسی نمی‌کند). اگر راز بود، مثل رمز یا کلید، وقتی در تاریخچه رفت آن را لورفته بدانید: راز را عوض کنید و ردیابی فایل را متوقف کنید: ```bash zev rm --cached .env echo ".env" >> .zevignore zev add .zevignore zev commit -m "دیگر .env دنبال نشود" ``` ### push من اشتباهی یک فایل خیلی بزرگ دارد ردیابی‌اش را متوقف کنید، نادیده‌اش بگیرید و کامیت کنید: ```bash zev rm --cached data/big.csv echo "data/big.csv" >> .zevignore zev add .zevignore zev commit -m "فایل CSV بزرگ دنبال نشود" ``` برای فایل‌های داده و مدلی که واقعاً می‌خواهید نگه دارید، zev با فایل‌های بزرگ خوب کنار می‌آید: در هر push فقط بخش‌های تغییرکردهٔ فایل فرستاده می‌شوند. ### zev فهرست بلندی از خط‌ها با "error:" و نام فایل‌ها چاپ کرد این گزارش یک خرابی است. لطفاً به ما بگویید: روی Zaryn یک issue باز کنید با دستوری که اجرا کردید و چند خط اول خروجی، یا از صفحهٔ تماس برایمان بنویسید. ### zev قدیمی است یا دستوری وجود ندارد ```bash zev --version zev self update ``` ### کلون یا دریافت کند است zev نسخهٔ ۰.۴ به بعد دسته‌ای دریافت می‌کند: چند درخواست به جای یکی برای هر فایل. نسخه‌های قدیمی‌تر هر فایل را جدا می‌گیرند که روی اتصال دور یا فیلترشده کند است. با `zev --version` نسخه را ببینید و با `zev self update` به‌روزش کنید. اگر هنوز کند است، شاید اتصال محدود شده باشد: [پراکسی](/docs/fa/proxy) را ببینید. ### هنوز نمی‌دانم چه کنم - `zev help <command>` هر دستوری را توضیح می‌دهد. - [چطور…؟](/docs/fa/how-do-i) کارهای رایج را پوشش می‌دهد. - از Zaryn بپرسید: صفحهٔ تماس به تیم می‌رسد.