@hile/cli 1.0.10 → 1.0.13

package/README.md

@@ -33,9 +33,12 @@ hile start --dev    # 开发模式：NODE_ENV=development，扫描 src/ 目录
 | 选项 | 说明 | 默认值 |
 |------|------|--------|
 | `-d, --dev` | 开发模式：设置 `NODE_ENV=development`，使用 tsx 运行 TypeScript，扫描 `src/` | `false` |
+| `-e, --env-file <path>` | 加载指定 env 文件到 `process.env`（与 Node 原生 `--env-file` 语义一致：先加载的优先，已存在的 key 不覆盖）。可多次指定 | — |
 
 未使用 `--dev` 时，CLI 会将 `process.env.NODE_ENV` 设为 `production`；使用 `--dev` 时设为 `development`，便于业务代码区分环境。
 
+**示例：** `hile start --env-file .env --env-file .env.local` 会先加载 `.env`，再加载 `.env.local`（后者不会覆盖前者已设置的变量）。依赖 Node 20.12+ 原生 `process.loadEnvFile()`。
+
 ### 其他
 
 ```bash

package/dist/index.js

@@ -7,6 +7,10 @@ import { resolve } from 'node:path';
 import { container, isService, loadService } from '@hile/core';
 import { createRequire } from 'node:module';
 const require = createRequire(import.meta.url);
+/** 加载 env 文件到 process.env（Node 20.12+ 原生 process.loadEnvFile） */
+function loadEnvFile(filePath) {
+    process.loadEnvFile(resolve(process.cwd(), filePath));
+}
 program.version(pkg.version, '-v, --version', '当前版本号');
 /**
  * 启动服务
@@ -21,8 +25,14 @@ program.version(pkg.version, '-v, --version', '当前版本号');
 program
     .command('start')
     .option('-d, --dev', '开发模式', false)
+    .option('-e, --env-file <path>', '加载指定 env 文件（兼容 Node --env-file 语义；可多次指定，先加载的不被后加载覆盖）', (v, acc) => (acc.push(v), acc), [])
     .description('启动服务，加载所有后缀为 boot.ts 或 boot.js 的服务，并注册退出钩子，在进程退出时销毁所有服务')
     .action(async (options) => {
+    // 先加载 --env-file（与 Node --env-file 行为一致：先加载的优先，已存在的 key 不被覆盖）
+    const envFiles = options.envFile ?? [];
+    for (const p of envFiles) {
+        loadEnvFile(p);
+    }
     // 开发模式下，使用 tsx 运行
     if (options.dev) {
         await import('tsx/esm');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hile/cli",
-  "version": "1.0.10",
+  "version": "1.0.13",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -29,5 +29,5 @@
     "glob": "^13.0.6",
     "tsx": "^4.21.0"
   },
-  "gitHead": "a6eab4e7803f0df7d4bca9a0bdeca76692dbc883"
+  "gitHead": "1070e55ba47e976946b8e1536dfda43211c3251a"
 }