`.env` 파일 관리 그만: Go 기반 TTY와 Env Manager인 Fana‑Envy를 만나보세요

발행: 4시간 전 (2025년 12월 19일 오전 07:14 GMT+9)

10 min read

Source: Dev.to

.env 파일을 뒤적이는 일은 이제 그만 – Go 기반 TTY와 환경 변수 관리자를 갖춘 Fana Envy를 만나보세요

프로젝트를 진행하면서 서로 다른 환경(development, staging, production 등)마다 별도의 .env 파일을 유지해야 하는 경우가 많습니다. 파일을 복사하고, 이름을 바꾸고, 때때로 잘못된 파일을 로드하면서 “내가 지금 어떤 환경을 사용하고 있지?” 라는 질문에 머리를 싸매게 됩니다.

이 글에서는 이러한 번거로움을 해소해 주는 Fana Envy라는 도구를 소개합니다. Go 로 작성된 TTY(터미널 UI)와 내장된 환경 변수 관리 기능을 제공해, 하나의 인터페이스에서 여러 .env 파일을 손쉽게 전환하고 편집할 수 있습니다.

왜 `.env` 파일 관리가 어려운가?

파일 복제와 이름 변경
환경마다 별도의 파일을 만들다 보면, 파일을 복제하거나 이름을 바꾸는 과정에서 실수가 발생합니다.
동일한 변수의 중복 정의
같은 변수명이 여러 파일에 존재하면, 어느 파일이 실제로 로드되는지 파악하기 어렵습니다.
CI/CD 파이프라인과의 불일치
로컬에서는 dev.env를 사용하고, 배포 환경에서는 prod.env를 사용한다면, 배포 스크립트가 올바른 파일을 가리키는지 매번 확인해야 합니다.
버전 관리 충돌
.env 파일을 Git에 포함시키면 팀원 간 충돌이 발생하고, 제외하면 배포 시 누락될 위험이 있습니다.

Fana Envy가 제공하는 솔루션

기능	설명
멀티 파일 로드	하나의 인터페이스에서 여러 `.env` 파일을 동시에 로드하고, 우선순위를 지정할 수 있습니다.
실시간 변수 오버라이드	현재 세션에서 변수 값을 즉시 수정하고, 변경 사항을 파일에 바로 저장합니다.
환경 스위칭	키보드 단축키(`←/→`)를 사용해 정의된 환경(예: `development`, `staging`, `production`)을 빠르게 전환합니다.
자동 완성	변수명과 파일명을 자동 완성해 입력 실수를 최소화합니다.
CI/CD 친화적	`fana-envy export` 명령으로 현재 세션의 변수를 `export` 형식으로 출력해 파이프라인에 바로 연결할 수 있습니다.
경량	Go 로 컴파일된 단일 바이너리이며, 별도의 런타임 의존성이 없습니다.

설치 방법

# Homebrew (macOS / Linux)
brew install adrian-fathan/tap/fana-envy

# 직접 바이너리 다운로드 (Linux, macOS, Windows)
curl -L https://github.com/adrian-fathan/fana-envy/releases/download/v1.2.0/fana-envy_1.2.0_$(uname -s)_$(uname -m).tar.gz | tar xz
sudo mv fana-envy /usr/local/bin/

Tip: 최신 버전은 GitHub Releases 페이지에서 확인할 수 있습니다.

기본 사용법

# 현재 디렉터리의 .env 파일들을 자동으로 감지하고 UI를 실행합니다.
fana-envy

주요 키 바인딩

키	동작
`← / →`	정의된 환경(예: `dev`, `stg`, `prod`) 사이 전환
`↑ / ↓`	변수 리스트에서 이동
`Enter`	선택한 변수를 편집
`Ctrl+S`	현재 파일에 변경 사항 저장
`Ctrl+E`	현재 세션의 변수를 `export` 형식으로 출력
`Ctrl+Q`	프로그램 종료

예시 시나리오

프로젝트 루트에 다음과 같은 파일이 있다고 가정합니다.

.env
.env.development
.env.staging
.env.production

Fana Envy 실행
```
fana-envy
```
환경 전환
← / → 키를 눌러 development → staging → production 순으로 전환합니다. UI 상단에 현재 로드된 파일 목록이 표시됩니다.
변수 편집
리스트에서 DATABASE_URL을 선택하고 Enter를 눌러 값을 수정합니다. Ctrl+S 로 저장하면 해당 파일에 즉시 반영됩니다.

CI 파이프라인에 적용

fana-envy export > .env.ci
# 이제 .env.ci 를 CI 스크립트에서 source 하면 됩니다.
source .env.ci

고급 기능

1️⃣ 파일 병합 순서 지정

.fanaenv.yml 파일을 프로젝트 루트에 두면 파일 로드 순서를 명시할 수 있습니다.

order:
  - .env
  - .env.development
  - .env.local

2️⃣ 변수 템플릿

환경 변수 값에 ${OTHER_VAR} 형태의 템플릿을 사용할 수 있습니다. Fana Envy는 실행 시점에 이를 자동으로 확장합니다.

API_ENDPOINT=https://api.${ENV}.example.com

3️⃣ 플러그인 시스템

Go 플러그인 인터페이스를 구현하면, 커스텀 검증 로직이나 비밀 관리 서비스(AWS Secrets Manager, HashiCorp Vault 등)와 연동할 수 있습니다.

// plugin/example.go
package main

import "github.com/adrian-fathan/fana-envy/plugin"

func Validate(key, value string) error {
    // 예: 특정 변수는 반드시 URL 형식이어야 함
    return nil
}

func main() {
    plugin.RegisterValidator(Validate)
}