Cách dùng Trình kiểm tra file .env
- Dán nội dung
.envvào ô bên trái. Nếu muốn, dán thêm.env.example(hoặc danh sách khóa bắt buộc) vào ô bên phải. - Đọc danh sách vấn đề: lỗi sẽ làm hỏng việc đọc file, còn cảnh báo thường là lỗi nhỏ hoặc giá trị có rủi ro.
- Xem bảng để kiểm tra từng biến — giá trị đã được che, nên bạn có thể chia sẻ ảnh chụp màn hình an toàn.
- Tải file
.env.exampleđã tạo và commit file này thay vì commit.envthật.
Cú pháp .env nhanh gọn
| Dòng | Kết quả |
|---|---|
PORT=3000 | Giá trị đơn giản |
APP_NAME="My App" | Cần dấu nháy khi có khoảng trắng |
GREETING='Hello $USER' | Nháy đơn: không mở rộng biến (dotenv-expand, Docker Compose) |
KEY="line1\nline2" | Nháy kép: \n được đổi thành xuống dòng |
export TOKEN=abc | Được phép có tiền tố export, dotenv sẽ bỏ qua |
# comment | Chú thích; sau giá trị chỉ được tính khi có khoảng trắng phía trước và giá trị không có dấu nháy |
Các lỗi phổ biến mà công cụ này phát hiện
- Khóa trùng — hầu hết trình nạp giữ lặng lẽ giá trị đầu hoặc cuối, nên thay đổi của bạn có vẻ không có tác dụng.
- Khoảng trắng quanh dấu = hoặc trong giá trị không có nháy —
KEY = valuesẽ lỗi trong shell và Docker. - Dấu nháy chưa đóng làm “nuốt” các dòng phía sau.
- Tên không hợp lệ — khóa chỉ nên gồm chữ, số và dấu gạch dưới, và không bắt đầu bằng chữ số.
- Secret như khóa AWS, khóa Stripe live, token GitHub hoặc private key — để trong .env cục bộ thì được, nhưng tuyệt đối không commit.
Giữ .env ngoài Git
Thêm .env vào .gitignore của bạn và commit một file .env.example chỉ chứa khóa. Trên CI, hãy lưu giá trị dưới dạng secret — xem GitHub Actions Workflow Generator. Các framework front-end đưa biến ra trình duyệt qua tiền tố như VITE_, NEXT_PUBLIC_ hoặc PUBLIC_ — đừng bao giờ đặt secret vào những biến đó.
Cũng được tìm dưới tên: kiểm tra file env, env file validator, kiểm tra cú pháp .env, dotenv validator, tạo file env example, kiểm tra biến môi trường, biến môi trường thiếu, định dạng file env.
Các công cụ dùng kèm tốt với Trình kiểm tra file .env
- Trình tạo Docker Compose — Chọn các dịch vụ bạn cần — ứng dụng, cơ sở dữ liệu, cache, giao diện quản trị, công cụ bắt mail — và nhận file compose.yaml gọn gàng với image đã ghim phiên bản, named volume, healthcheck và điều kiện depends_on, cùng file .env có sẵn mật khẩu được tạo ngẫu nhiên.
- Tạo package.json — Điền form để có file package.json hợp lệ — kiểm tra tên npm, script mẫu cho Vite, Next.js, Node và thư viện TypeScript, exports, engines, license và repository — kèm cảnh báo các lỗi thường gặp.
- Kiểm tra ký tự Unicode — Dán bất kỳ nội dung nào để xem nó thực sự được tạo từ những gì: tên, code point, byte UTF-8 và mã HTML của từng ký tự.
- So sánh văn bản — Dán bản gốc và bản đã chỉnh sửa để xem các dòng được thêm, xóa và thay đổi song song, kèm các từ chính xác đã đổi được tô sáng trong từng dòng.
Câu hỏi thường gặp
Dán file .env của tôi vào đây có an toàn không?
Công cụ chỉ chạy trong trình duyệt của bạn; không có gì được tải lên hay lưu lại. Giá trị được che trong báo cáo. Tuy vậy, nếu chính sách của bạn không cho phép, đừng dán secret production vào bất kỳ website nào — hãy dùng file ví dụ thay thế.
Trong file .env có cần dấu nháy không?
Chỉ cần khi giá trị có khoảng trắng, #, dấu nháy hoặc xuống dòng, hoặc bắt đầu bằng ký tự đặc biệt. Nháy kép cho phép escape như \n; nháy đơn giữ nguyên giá trị theo nghĩa đen.
.env.example dùng để làm gì?
Nó ghi lại các biến mà dự án cần, nhưng không có giá trị thật. Hãy commit file này để đồng đội mới và CI biết cần cấu hình gì; còn file .env thật thì giữ ngoài Git.
Tại sao biến của tôi vẫn báo undefined?
Các nguyên nhân thường gặp: gõ sai hoặc khác chữ hoa/thường trong tên khóa, có khóa trùng phía sau trong file, khoảng trắng quanh dấu =, dấu nháy chưa đóng ở dòng phía trên, hoặc file không được nạp (sai thư mục hoặc chưa cấu hình dotenv). Các bundler front-end cũng yêu cầu tiền tố như VITE_ hoặc NEXT_PUBLIC_.
Tôi có thể cài Trình kiểm tra file .env như một ứng dụng web và dùng khi không có mạng không?
Có. Trình kiểm tra file .env là một ứng dụng web (PWA) có thể cài đặt — cài trực tiếp từ trình duyệt, không cần tải từ cửa hàng ứng dụng. Trên Chrome hoặc Edge (Windows, macOS, Linux, ChromeOS) hoặc Android, bấm Cài đặt ứng dụng ở đầu trang này; trên iPhone và iPad, dùng Chia sẻ → Thêm vào Màn hình chính; trên Mac, dùng File → Add to Dock trong Safari 17 trở lên. Sau đó ứng dụng mở trong cửa sổ riêng với biểu tượng riêng, và vì chạy hoàn toàn trên trình duyệt nên vẫn hoạt động khi không có mạng. Firefox trên máy tính không thể cài ứng dụng web. Cách cài đặt hoạt động thế nào.