底層運作原理
將您貼上的 `.env` 文字內容在瀏覽器記憶體中進行語法解析,識別 `KEY=VALUE`、`export ` 前綴、單雙引號與 `#` 註解行(同一檔案重複鍵名依規範採後者覆寫)。在比對模式中逐鍵標示 `+` 新增、`-` 移除與 `~` 異動;在清理模式中自動辨識含 `secret`、`key`、`token`、`password`、`dsn` 等敏感名稱的鍵值並清空內容,同時保留 `PORT=3000` 等非機密預設值。
詳細操作步驟
選擇作業模式:「比對兩份 .env 檔案」、「清理機密產生 .env.example」或「排序並格式化 .env」。
貼上來源環境變數內容(比對模式則分別貼入基準環境與目標環境,例如 local 與 production)。
檢視結構化差異高亮標記,或確認已被自動遮罩清除的機密變數清單。
一鍵複製結果或直接下載整理後的 `.env.example` 檔案提交至 Git 儲存庫。
核心功能與效能優勢
- 支援三合一工作流程:雙檔差異比對(Diff)、機密清零範本化、字母排序與註解保留
- 智慧判斷 `SECRET`、`KEY`、`TOKEN`、`PASSWORD`、`AUTH`、`DSN` 等敏感鍵名並自動留白
- 保留 `PORT`、`NODE_ENV` 等安全組態值,產出的 `.env.example` 更具開發參考價值
- 完整相容 `export KEY=VAL` 語法、多型引號包裹值與同檔重複鍵最後覆寫規則
- 100% 瀏覽器離線本地運算,您的生產環境資料庫密碼與 API 金鑰絕不觸及任何網路或伺服器
運算方法、公式與技術標準
解析器逐行讀取並處理 `export ` 前綴、首尾成對引號及註解,按出現順序建立 Map(重複鍵採 last-wins 覆寫)。比對模式執行集合差與值相等檢查輸出 `+`/`-`/`~`;清理模式以正則規則比對鍵名關鍵字,命中者將值重置為空字串並保留註解結構。
常見實務應用情境
- 部署上線前比對 `.env.local` 與線上環境變數清單,避免因漏設某個 Key 導致服務崩潰
- 開源專案或團隊協作時,從本機 `.env` 安全抽離機密並產出乾淨的 `.env.example` 放進 Git
- 將長年累積、雜亂無章的數十行環境變數重新按字母排序與對齊格式化
- 在 CI/CD 腳本或 Docker Compose 設定調整前後,快速驗證改動了哪些設定值
實作範例與邊界案例
Secret Scrubbing to .env.example
STRIPE_SECRET_KEY=sk_live_abc123 PORT=3000
STRIPE_SECRET_KEY=YOUR_STRIPE_SECRET_KEY PORT=3000
Secret credentials are replaced while non-secret operational defaults stay readable.
Environment Drift Detection
Left: CACHE_TTL=3600 | Right: CACHE_TTL=86400 + SENTRY_DSN=...
~1 changed (CACHE_TTL), +1 added (SENTRY_DSN)
Immediately reveals missing observability variables across environments.
使用限制與精準度說明
- • 若檔案內使用 `${HOST}` 等變數插值語法,工具會將其視為純文字字串直接比對,不會動態展開。
- • 若團隊使用了非傳統命名的機密鍵(例如只叫 `STRIPE_LIVE`),輸出 `.env.example` 前仍請人工覆核一次。
瀏覽器本地運算與隱私保障
傳統線上轉換網站會將您的文件、文字片段或影音檔案上傳至遠端伺服器。.env 環境變數比對與機密遮罩工具 完全在您的瀏覽器分頁內運行:
您的檔案與文字都在裝置本機計算,不會傳送內容至任何後端伺服器。
Microdeck 不會記錄或儲存您在工具內貼上的任何檔案或程式碼。
所有暫存結果僅存在目前分頁記憶體中,重設或關閉分頁後即刻清除。
常見問題 (FAQ)
把真實的正式環境 .env 貼到這個網頁安全嗎?
請完全放心。本工具屬於純前端靜態頁面,所有解析、比對與遮罩都在您的瀏覽器記憶體內本地執行,零 API 請求、零雲端紀錄。
「清理機密」模式會把所有變數的值都清空嗎?
不會。工具只會針對名稱包含 secret、key、token、password、dsn、auth 等常見機密特徵的變數清零,像 PORT=3000 或 LOG_LEVEL=info 這類無害設定會貼心保留。
如果同一個 .env 檔案裡不小心寫了兩次相同的鍵名怎麼辦?
與 dotenv 標準行為一致,解析器會採用「最後出現者優先(Last-wins)」原則進行比對與整理。
支援在 Shell 常用的 `export API_KEY=...` 寫法嗎?
支援。解析器會自動識別並正規化 `export ` 前綴,讓 Shell 環境設定檔與一般 `.env` 檔也能正確比對。