diff --git a/README.md b/README.md
index e5056ca..5136eb2 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,19 @@ pnpm install
 pnpm dev        # http://localhost:5501
 ```
 
+## 环境变量
+
+按环境拆分，已随仓库提交（参考 uirefbase 约定）：`.env.development` / `.env.staging` / `.env.production`。
+本地私有覆盖请写入 `.env*.local`（已被 `.gitignore` 忽略，不入库）。
+
+| 变量 | 说明 | 示例 |
+|------|------|------|
+| `NEXT_PUBLIC_BASE_PATH` | 部署子路径，无则留空 | `""` |
+| `NEXT_PUBLIC_SHARED_API_PATH` | 后端 basis 服务地址（登录 / 验证码 / 租户列表都走这里） | dev: `http://172.16.115.31:6610/`<br>prod: `http://basis-app-svc:6610` |
+
+> 无密钥，可安全入库。Next.js 会按 `NODE_ENV` 自动加载对应文件（`next dev` → development，`next build/start` → production）。
+
+
 ## 测试账号
 
 | 账号 | 密码 | 姓名 |