تواصل معنا
Webflow Premium Partner إيهاب فايز
العودة لأدوات AI Coding
الأمان والجودة

dotenv Environment Management

تحميل متغيرات البيئة من ملفات .env إلى process.env للتطوير المحلي والتكوين.

Claude Code Cursor Copilot Windsurf Gemini CLI Codex

نظرة عامة

dotenv هي وحدة بدون تبعيات تحمل متغيرات البيئة من ملف .env إلى process.env. تتبع منهجية تطبيق العوامل الاثني عشر بفصل التكوين عن الكود مما يسهل تغيير الإعدادات بين البيئات دون تعديل كود التطبيق.

تدعم المكتبة توسيع المتغيرات (الإشارة إلى متغيرات أخرى) والقيم متعددة الأسطر والتعليقات. توفر حزمة dotenv-expand المرافقة استيفاء المتغيرات داخل ملفات .env. لمشاريع TypeScript يوفر dotenv تعريفات الأنواع ويعمل بسلاسة مع مكتبات التحقق مثل Zod أو t3-env لضمان وجود جميع متغيرات البيئة المطلوبة وكتابتها بشكل صحيح.

تشمل أفضل الممارسات الأمنية مع dotenv عدم تضمين ملفات .env في التحكم بالإصدار (إضافتها إلى .gitignore) وتوفير ملف .env.example بقيم نائبة للتوثيق واستخدام ملفات .env مختلفة لبيئات مختلفة (.env.local و.env.production). يضيف امتداد dotenv-vault إدارة ملفات .env المشفرة للتعاون الجماعي ونشر CI/CD.

لمن هذه الأداة؟

  • تحميل عناوين URL لقاعدة البيانات ومفاتيح API من ملفات .env
  • إعداد تكوين خاص بالبيئة للتطوير/التجهيز/الإنتاج
  • التحقق من متغيرات البيئة بمخططات Zod
  • مشاركة تكوينات البيئة بأمان عبر الفريق

التثبيت

إعداد Claude Code
npm install dotenv

الإعدادات

// .env
DATABASE_URL="postgresql://user:pass@localhost:5432/mydb"
API_KEY="sk-1234567890"

// app.ts
import "dotenv/config"
// or
import dotenv from "dotenv"
dotenv.config()

console.log(process.env.DATABASE_URL)