.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 以分享給團隊前,先在此整理與確認變數清單。
Send Feedback
Please let us know your thoughts to help us improve the tool.
Feedback is temporarily suspended
The server is busy or spam protection is active. Please try again later.