https://dev.tldrlss.com/ar/tags/%D9%85%D8%AA%D8%BA%D9%8A%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D8%A8%D9%8A%D8%A6%D8%A9/ Recent content in متغيرات البيئة on Dev TLDRLSS Hugo -- gohugo.io ar Fri, 07 Aug 2026 18:31:00 +0800 https://dev.tldrlss.com/ar/article/2026/08/zshrc-env-clear-mac-terminal-environment-variables/ Fri, 07 Aug 2026 18:31:00 +0800 https://dev.tldrlss.com/ar/article/2026/08/zshrc-env-clear-mac-terminal-environment-variables/ <img src="https://dev.tldrlss.com/global-assets/images/scenario/developer-pitfall-1.jpg" alt="Featured image of post لماذا تظل متغيرات البيئة المحذوفة من .zshrc سارية المفعول؟ لماذا لا يؤدي إعادة تشغيل source ~/.zshrc إلى مسح المتغيرات القديمة؟ لماذا تظل متغيرات البيئة موجودة عند إعادة فتح نوافذ الطرفية؟ كيف تمسح متغيرات البيئة تمامًا في الطرفية المدمجة لـ IDE وتطبيقات Terminal؟" /><p>على الرغم من أنك قمت بحذف <code>متغير البيئة</code> (مثل <code>ANTHROPIC_BASE_URL</code>) من <code>~/.zshrc</code>، إلا أنه عندما تتحقق في الطرفية، تفاجأ بأنه لا يزال موجودًا!</p> <p>حتى إعادة تنفيذ <code>source ~/.zshrc</code> لا تجدي نفعًا على الإطلاق؟</p> <h2 id="كيف-تتحقق-مما-إذا-كان-متغير-البيئة-موجودا-وأي-ملف-تكوين-تم-كتابته-به">كيف تتحقق مما إذا كان متغير البيئة موجودًا وأي ملف تكوين تم كتابته به؟ </h2><p>قبل البدء في التنظيف، عليك أولاً التأكد مما إذا كان المتغير لا يزال في الذاكرة الحالية وأي ملف تكوين يقوم بتحميله تلقائيًا.</p> <h3 id="1-التحقق-من-متغيرات-الذاكرة">1. التحقق من متغيرات الذاكرة </h3><p>تحقق مما إذا كان <code>متغير البيئة</code> لا يزال متبقيًا في ذاكرة <code>Terminal</code> الحالية</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">env <span class="p">|</span> grep -i anthropic </span></span></code></pre></div><h3 id="2-البحث-عن-مصادر-ملفات-التكوين">2. البحث عن مصادر ملفات التكوين </h3><p>ابحث بشكل شامل في ملفات تكوين <code>Zsh</code> و <code>Bash</code> وعلى مستوى النظام لمعرفة الملف الذي كتب المتغير</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">grep -rn <span class="s2">&#34;ANTHROPIC_BASE_URL&#34;</span> ~/.zshrc ~/.zprofile ~/.zshenv ~/.zlogin ~/.bashrc ~/.bash_profile ~/.profile /etc/zshenv /etc/zprofile /etc/profile /etc/environment 2&gt;/dev/null </span></span></code></pre></div><!--adsense--> <h2 id="لماذا-تظل-متغيرات-البيئة-القديمة-موجودة-بعد-تعديل-zshrc">لماذا تظل متغيرات البيئة القديمة موجودة بعد تعديل .zshrc؟ </h2><p>في الواقع، عندما تفتح الطرفية، يتم تحميل <code>متغيرات البيئة</code> بالفعل في &ldquo;الذاكرة&rdquo; الخاصة بهذا الاتصال.</p> <p>حتى لو قمت بتعديل الملف أو إعادة تنفيذ <code>source ~/.zshrc</code>، فإن هذا يعيد تحميل المحتوى في ملف التكوين فقط ولا يمسح تلقائيًا المتغيرات القديمة الموجودة في الذاكرة.</p> <blockquote> <p>أمر <code>source</code> <strong>يقوم فقط بالكتابة فوق المتغيرات أو إضافتها، ولا يقوم بـ &ldquo;حذف&rdquo; المتغيرات نيابة عنك</strong></p> </blockquote> <p>في هذه المرحلة، تكون أسهل الحلول كما يلي:</p> <table> <thead> <tr> <th>طريقة المسح</th> <th>أمر التشغيل / الإجراء</th> <th>الوصف</th> </tr> </thead> <tbody> <tr> <td><strong>فتح نافذة جديدة</strong></td> <td>فتح علامة تبويب طرفية جديدة تمامًا</td> <td>سيقوم <code>Shell Process</code> الجديد بإعادة قراءة أحدث <code>~/.zshrc</code></td> </tr> <tr> <td><strong>المسح اليدوي</strong></td> <td><code>unset ANTHROPIC_BASE_URL</code></td> <td>حذف <code>متغير البيئة</code> المحدد مباشرة من الذاكرة الحالية</td> </tr> <tr> <td><strong>إعادة ضبط shell</strong></td> <td><code>exec zsh -l</code></td> <td>إعادة تحميل حالة ذاكرة <code>Shell</code> الحالية</td> </tr> </tbody> </table> <h2 id="إعادة-فتح-نافذة-الطرفية-لا-فائدة-منها-اكتشف-الجناة-الثلاثة-الكبار">إعادة فتح نافذة الطرفية لا فائدة منها؟ اكتشف الجناة الثلاثة الكبار </h2><p>لماذا يحدث أحيانًا أنه حتى بعد فتح نافذة طرفية جديدة تمامًا، يظل <code>متغير البيئة</code> القديم يلاحقك؟</p> <p>في هذه الحالة، لم تعد المشكلة في <code>~/.zshrc</code>، بل تأتي من وراثة &ldquo;العملية الأصلية (Parent Process)&rdquo;!</p> <p>عندما تبدأ طرفية من تطبيق برمجيات، تانسخ العملية الفرعية مباشرة لقطة متغيرات البيئة للعملية الأصلية في ذلك الوقت.</p> <p>إذا واجهت <code>متغير بيئة</code> عنيدًا كهذا، فعادة ما يكون ذلك لثلاثة أسباب شائعة التالية:</p> <table> <thead> <tr> <th>النوع</th> <th>السبب</th> <th>الحل</th> </tr> </thead> <tbody> <tr> <td><strong>الطرفية المدمجة بـ IDE</strong></td> <td>سجلت <code>VS Code</code> أو <code>Cursor</code> أو <code>Antigravity</code> لقطة لمتغيرات البيئة عند بدء التشغيل</td> <td>اضغط على <code>Cmd + Q</code> للخروج تمامًا من <code>IDE</code> ثم أعد فتحه</td> </tr> <tr> <td><strong>تطبيق الطرفية لم يغلق</strong></td> <td><code>Terminal</code> أو <code>iTerm2</code> على Mac أغلقت النوافذ فقط (<code>Cmd + W</code>)، والتطبيق الرئيسي يعمل في الخلفية</td> <td>اضغط على <code>Cmd + Q</code> للخروج تمامًا من تطبيق <code>Terminal</code></td> </tr> <tr> <td><strong>tmux</strong></td> <td>خادم الخلفية لـ <code>tmux</code> يعمل باستمرار، وتستمر التبويبات الجديدة في وراثة الإعدادات عند البدء</td> <td>نفذ <code>tmux kill-server</code> لإغلاق خدمة الخلفية</td> </tr> </tbody> </table> <!--adsense--> <h2 id="إعادة-تشغيل-البرنامج-لا-تزال-غير-فعالة-تحقق-من-أدوات-الطرف-الثالث-وإعدادات-مستوى-النظام">إعادة تشغيل البرنامج لا تزال غير فعالة؟ تحقق من أدوات الطرف الثالث وإعدادات مستوى النظام </h2><p>إذا فشلت الطرق الثلاث المذكورة أعلاه وظل <code>متغير البيئة</code> يظهر بعناد في <code>Terminal</code>، فقد تكون إعدادات النظام الأعلى أو أدوات الطرف الثالث تعمل خلف الكواليس.</p> <blockquote> <p><strong>ستؤدي أذونات النظام الأعلى أو نصوص الغلاف (wrapper) إلى استعادة متغيرات البيئة تلقائيًا في كل مرة تبدأ فيها</strong></p> </blockquote> <p>في هذه الحالة، يمكنك استخدام أمرين رئيسيين للكشف كالتالي:</p> <table> <thead> <tr> <th>هدف الكشف</th> <th>الأمر</th> <th>الوصف</th> </tr> </thead> <tbody> <tr> <td><strong>متغيرات النظام العامة</strong></td> <td><code>launchctl getenv ANTHROPIC_BASE_URL</code></td> <td>التحقق مما إذا كانت أدوات الوكيل التابعة لجهات خارجية تستخدم <code>launchctl setenv</code> لكتابة متغيرات عامة</td> </tr> <tr> <td><strong>نصوص غلاف الأوامر</strong></td> <td><code>type claude</code></td> <td>التحقق مما إذا كان الأمر الحالي هو الملف التنفيذي الأصلي أو ملفوفًا في نص <code>wrapper</code> بمتغيرات افتراضية</td> </tr> </tbody> </table> <h2 id="خطوات-استكشاف-الأخطاء-وإصلاحها-القياسية-لمسح-متغيرات-البيئة-تماما">خطوات استكشاف الأخطاء وإصلاحها القياسية لمسح متغيرات البيئة تمامًا </h2><p>في المرة القادمة التي تقوم فيها بتعديل أو حذف <code>متغيرات البيئة</code> في <code>~/.zshrc</code>، تذكر أن تتأكد أولاً: هل ترث الطرفية الحالية إعدادات <code>Parent Process</code> القديمة؟</p> <p>من خلال اتباع تسلسل الفحص التالي، يمكنك العثور بسهولة على السبب الجذر وحل المشكلة:</p> <ol> <li>نفذ أمر <code>unset اسم_المتغير</code> أولاً أو افتح نافذة طرفية جديدة تمامًا.</li> <li>إذا كنت تستخدم <code>IDE</code> مثل <code>VS Code</code> أو <code>Cursor</code>، اضغط على <code>Cmd + Q</code> لإعادة تشغيل <code>IDE</code> تمامًا.</li> <li>إذا كنت تستخدم <code>tmux</code>، نفذ <code>tmux kill-server</code> لإعادة ضبط خدمة الخلفية.</li> <li>تحقق من أمري <code>launchctl getenv</code> و <code>type</code> للتحقق من مستوى النظام ونصوص الغلاف.</li> </ol>