.env 驗證工具
線上檢查 .env 檔案語法,抓出重複變數,並將所有設定值整理為清晰的表格。
純前端本地端處理,保障您的 API Key 等機密資料絕不外洩。
關於本工具
這是一個免費的線上開發者工具,專門用來驗證與分析 .env (環境變數) 檔案。它能即時檢查語法錯誤、抓出不小心重複定義的變數名稱,並將所有變數列出。完全相容於 Node.js dotenv 套件以及 Docker Compose 的 env_file 格式規範。
為了避免在截圖或分享畫面時不慎洩漏機密,在下方的變數表格中,名稱包含 KEY、SECRET、TOKEN、PASSWORD 的變數值會被自動遮蔽 (Masked)。同時,所有的解析都在您的瀏覽器本地端進行,資料絕對不會離開您的裝置。
使用方法
貼上 .env 內容
開啟您的 .env 檔案,全選複製後貼入上方的文字區塊。
即時查看分析結果
系統會即時顯示語法錯誤 (Errors)、重複定義警告 (Warnings) 以及所有變數的清單表格。
修正錯誤
根據錯誤提示的行號 (Line number),回到您的程式碼編輯器中進行修正。
名詞解釋
- .env 檔案
- 一種用於定義專案環境變數的純文字檔,遵循 KEY=VALUE 的格式。為了資安考量,通常會被加入 .gitignore 中,避免提交到版本控制系統內。
- 環境變數 (Environment Variable)
- 作業系統層級的變數。應用程式會在執行時讀取這些變數來決定組態設定,例如資料庫連線帳密或 API 金鑰,這使得同一套程式碼可以在不同環境下獨立運作。
- 12-Factor App
- 一種建立現代軟體即服務 (SaaS) 的方法論。其中第三條原則 (Factor III) 明確指出,應用程式的組態設定應該儲存在環境變數中,而非寫死在程式碼內。
- dotenv
- Node.js 生態系中最著名的套件之一,負責讀取 .env 檔案並將其中的變數注入到 process.env 供程式使用。
- 機密管理 (Secret Management)
- 保護與管理 API Key 等機密資訊的最佳實務。在正式的 Production 環境中,建議使用 AWS Secrets Manager 或 HashiCorp Vault 等專業服務,而非單純依賴 .env 檔案。
- 註解行 (Comment Line)
- 在 .env 檔案中,以井號 (#) 開頭的行會被視為註解,解析器在讀取時會自動將其忽略。
常見問題
- Q.貼上 API Key 等機密資訊安全嗎?
- 非常安全。本工具的所有解析與驗證程式碼完全在您的瀏覽器端執行,您的 .env 內容絕對不會被傳送到任何伺服器上。
- Q.支援引號包覆的值嗎?
- 支援。無論是單引號或雙引號包覆的值(例如 SECRET="my value"),都能正確解析並去除外層引號。
- Q.這能用來檢查 .env.local 或 .env.production 嗎?
- 可以的。只要內容符合標準的 KEY=VALUE 格式,任何檔名或環境設定檔皆可支援驗證。
- Q.支援多行 (Multi-line) 的變數值嗎?
- 不支援。本工具目前專注於驗證單行的 KEY=VALUE 結構,無法解析使用 heredoc 或跨多行的變數值。
使用場景
🖥️ Node.js 專案開發
在啟動 App 或 npm script 前,先快速檢查 .env 檔案是否有打錯字或漏掉等號。
🐳 Docker Compose 設定
驗證準備透過 docker-compose.yml 掛載進 Container 的 env_file 是否符合格式。
🔐 部署前終極檢查 (Pre-Deploy)
在上線到 Production 環境之前,確認所有必填的連線字串與環境變數都已正確定義。
👥 團隊合作分享
在將 .env 複製並修改為 .env.example 以分享給團隊前,先在此整理與確認變數清單。
發送反饋
請告訴我們您的想法,以幫助我們改進工具。
Feedback is temporarily suspended
The server is busy or spam protection is active. Please try again later.