يحوّل الأسماء المكتوبة بأسلوب متغيرات البيئة إلى kebab-case: LOG_LEVEL → log-level، WORKER_COUNT → worker-count. كثيرًا ما يصف النمطان الإعداد نفسه في أماكن مختلفة: متغير بيئة من جهة، ومن الجهة الأخرى خيار سطر أوامر --log-level أو قيمة Helm أو مفتاح ConfigMap في Kubernetes.
الصق ملف .env أو قائمة متغيرات لتحصل على الأسماء الصغيرة الموصولة بشرطات التي تستخدمها أدوات CLI وكثير من الأدوات المعتمدة على YAML.
نص السلسلة، مع قيمها أو دونها.النتيجة؛ وأضف -- في البداية إن احتجت إلى صيغة الخيارات.LOG_LEVEL=debug
CACHE_DIR=/tmp/app-cache
WORKER_COUNT=4log-level=debug
cache-dir=/tmp/app-cache
worker-count=4تُحوَّل الأسماء التي قبل =؛ أما المسار /tmp/app-cache فيستخدم أصلًا الشرطات والأحرف الصغيرة، فلا يُتعرّف عليه كـ SCREAMING_SNAKE_CASE ويبقى دون تغيير.
CACHE_DIR → cache-dir._INTERNAL_FLAG → internal-flag.تقبل أدوات كثيرة الخيار نفسه بالصيغة MYAPP_LOG_LEVEL أو --log-level. تحويل قائمة متغيرات البيئة يساعد في كتابة تعريفات الخيارات ونص المساعدة.
تستخدم Helm charts وConfigMaps غالبًا مفاتيح موصولة بشرطات أو بصيغة camelCase، بينما تقرأ الحاويات متغيرات بصيغة SCREAMING_SNAKE_CASE. التحويل يعطيك أسماء المفاتيح لجانب الـ chart في هذا الربط.
HTTP_2_ENABLED → http-2-enabled.PORT لا تُحوَّل.ليس بشكل محمول. معظم الـ shells لا تسمح بالشرطات في أسماء المتغيرات، لذا أبقِ SCREAMING_SNAKE_CASE للمتغيرات نفسها واستخدم kebab-case للخيارات ومفاتيح الإعدادات.
--؟لا. الاسم وحده يتغير. وإن كان الإدخال يحوي -- أصلًا فإنه يُحفظ.