@ruan-cat/vercel-deploy-tool 1.0.0 → 1.1.0

package/README.md

@@ -99,6 +99,13 @@ pnpm run deploy-vercel
 npx vercel-deploy-tool deploy
 # 或使用短别名
 npx vdt deploy
+
+# 如需指定自定义 dotenv 文件
+npx vdt deploy --env-path .env.production
+# 等价：设置环境变量再运行
+VERCEL_DEPLOY_TOOL_ENV_PATH=.env.production npx vdt deploy
+# 多文件场景（依赖 dotenvx）
+dotenvx run -f .env.test -f .env.test-2 -- vdt deploy
 ```
 
 ### 方式二：使用 API
@@ -256,6 +263,13 @@ export default defineConfig({
    - 部署到 Vercel
    - 设置自定义域名别名
 
+### 环境变量优先级
+
+- `--env-path` / `VERCEL_DEPLOY_TOOL_ENV_PATH` 指定的 dotenv（如 `.env.production`）
+- 现有 `process.env`
+- c12 自动加载的 `.env*`
+- 配置默认值
+
 ## 📋 .gitignore 配置
 
 添加以下内容到 `.gitignore`：

package/dist/cli.js

@@ -9,12 +9,13 @@ import { Command as Command3 } from "commander";
 // src/commands/deploy.ts
 import { Command } from "commander";
 import { consola as consola10 } from "consola";
+import { config as dotenvxConfig2 } from "@dotenvx/dotenvx";
 
 // src/config/loader.ts
 import { loadConfig as c12LoadConfig } from "c12";
-import { resolve } from "pathe";
 import { consola } from "consola";
 import { isUndefined } from "lodash-es";
+import { config as dotenvxConfig } from "@dotenvx/dotenvx";
 import { printFormat } from "@ruan-cat/utils";
 var CONFIG_NAME = "vercel-deploy-tool";
 var DEFAULT_CONFIG = {
@@ -25,32 +26,40 @@ var DEFAULT_CONFIG = {
   deployTargets: []
 };
 async function loadConfig() {
-  const { config: config2 } = await c12LoadConfig({
-    cwd: resolve("."),
+  consola.start("\u5F00\u59CB\u8BFB\u53D6\u914D\u7F6E\u6587\u4EF6 vercel-deploy-tool.config.* ...");
+  const envPath = process.env.VERCEL_DEPLOY_TOOL_ENV_PATH;
+  if (envPath) {
+    dotenvxConfig({ path: envPath });
+    consola.info(`\u5DF2\u4ECE VERCEL_DEPLOY_TOOL_ENV_PATH \u52A0\u8F7D dotenv: ${envPath}`);
+  }
+  let config;
+  const loaded = await c12LoadConfig({
+    cwd: process.cwd(),
     name: CONFIG_NAME,
     dotenv: true,
     defaults: DEFAULT_CONFIG
   });
+  config = loaded.config;
   const vercelOrgId = process.env.VERCEL_ORG_ID;
   const vercelProjectId = process.env.VERCEL_PROJECT_ID;
   const vercelToken = process.env.VERCEL_TOKEN;
   if (!isUndefined(vercelOrgId)) {
-    config2.vercelOrgId = vercelOrgId;
+    config.vercelOrgId = vercelOrgId;
   }
   if (!isUndefined(vercelProjectId)) {
-    config2.vercelProjectId = vercelProjectId;
+    config.vercelProjectId = vercelProjectId;
   }
   if (!isUndefined(vercelToken)) {
-    config2.vercelToken = vercelToken;
+    config.vercelToken = vercelToken;
   }
   consola.success("\u914D\u7F6E\u52A0\u8F7D\u5B8C\u6210");
-  consola.box(printFormat(config2));
-  return config2;
+  consola.box(printFormat(config));
+  return config;
 }
-var config = await loadConfig();
 
 // src/core/tasks/index.ts
-import fs from "fs";
+import fs4 from "fs";
+import { resolve as resolve5 } from "path";
 import { consola as consola9 } from "consola";
 
 // src/core/executor.ts
@@ -105,19 +114,21 @@ var VERCEL_NULL_CONFIG_PATH = "./vercel.null.def.json";
 var VERCEL_OUTPUT_STATIC = ".vercel/output/static";
 
 // src/core/tasks/link.ts
+import fs from "fs";
+import { resolve } from "path";
 import { spawnSync } from "child_process";
 import { concat } from "lodash-es";
 import { consola as consola2 } from "consola";
 
 // src/core/vercel.ts
-function getVercelProjectNameArg(config2) {
-  return ["--name", config2.vercelProjectName];
+function getVercelProjectNameArg(config) {
+  return ["--project", config.vercelProjectName];
 }
-function getVercelScopeArg(config2) {
-  return ["--scope", config2.vercelOrgId];
+function getVercelScopeArg(config) {
+  return ["--scope", config.vercelOrgId];
 }
-function getVercelTokenArg(config2) {
-  return ["--token", config2.vercelToken];
+function getVercelTokenArg(config) {
+  return ["--token", config.vercelToken];
 }
 function getVercelLocalConfigArg() {
   return ["--local-config", VERCEL_NULL_CONFIG_PATH];
@@ -125,24 +136,37 @@ function getVercelLocalConfigArg() {
 function getTargetCWDArg(target) {
   return ["--cwd", target.targetCWD];
 }
+function createVercelSpawnOptions(stdoutMode = "inherit") {
+  const base = {
+    encoding: "utf8",
+    shell: process.platform === "win32"
+  };
+  if (stdoutMode === "pipe") {
+    return { ...base, stdio: ["inherit", "pipe", "inherit"] };
+  }
+  return { ...base, stdio: "inherit" };
+}
 
 // src/core/tasks/link.ts
-function createLinkTask(config2, target) {
+function createLinkTask(config, target) {
   return {
     name: `Link: ${target.targetCWD}`,
     fn: async () => {
+      const targetPath = resolve(target.targetCWD);
+      if (!fs.existsSync(targetPath)) {
+        const err = new Error(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6784\u5EFA: ${target.targetCWD}`);
+        consola2.error(err.message);
+        throw err;
+      }
       const args = concat(
         ["link"],
         ["--yes"],
         getTargetCWDArg(target),
-        getVercelProjectNameArg(config2),
-        getVercelTokenArg(config2)
+        getVercelProjectNameArg(config),
+        getVercelTokenArg(config)
       );
       consola2.start(`\u5F00\u59CB link \u4EFB\u52A1: ${target.targetCWD}`);
-      const result = spawnSync("vercel", args, {
-        encoding: "utf-8",
-        stdio: "inherit"
-      });
+      const result = spawnSync("vercel", args, createVercelSpawnOptions());
       if (result.error) {
         consola2.error(`link \u4EFB\u52A1\u5931\u8D25: ${target.targetCWD}`);
         throw result.error;
@@ -154,26 +178,31 @@ function createLinkTask(config2, target) {
 }
 
 // src/core/tasks/build.ts
+import fs2 from "fs";
+import { resolve as resolve2 } from "path";
 import { spawnSync as spawnSync2 } from "child_process";
 import { concat as concat2 } from "lodash-es";
 import { consola as consola3 } from "consola";
-function createBuildTask(config2, target) {
+function createBuildTask(config, target) {
   return {
     name: `Build: ${target.targetCWD}`,
     fn: async () => {
+      const targetPath = resolve2(target.targetCWD);
+      if (!fs2.existsSync(targetPath)) {
+        const err = new Error(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6784\u5EFA: ${target.targetCWD}`);
+        consola3.error(err.message);
+        throw err;
+      }
       const args = concat2(
         ["build"],
         ["--yes"],
         ["--prod"],
         getTargetCWDArg(target),
         getVercelLocalConfigArg(),
-        getVercelTokenArg(config2)
+        getVercelTokenArg(config)
       );
       consola3.start(`\u5F00\u59CB build \u4EFB\u52A1: ${target.targetCWD}`);
-      const result = spawnSync2("vercel", args, {
-        encoding: "utf-8",
-        stdio: "inherit"
-      });
+      const result = spawnSync2("vercel", args, createVercelSpawnOptions());
       if (result.error) {
         consola3.error(`build \u4EFB\u52A1\u5931\u8D25: ${target.targetCWD}`);
         throw result.error;
@@ -188,8 +217,8 @@ function createBuildTask(config2, target) {
 import { spawnSync as spawnSync3 } from "child_process";
 import { consola as consola4 } from "consola";
 import { isUndefined as isUndefined2, isEmpty } from "lodash-es";
-function createAfterBuildTasks(config2) {
-  const afterBuildTasks = config2.afterBuildTasks;
+function createAfterBuildTasks(config) {
+  const afterBuildTasks = config.afterBuildTasks;
   if (isUndefined2(afterBuildTasks) || isEmpty(afterBuildTasks)) {
     return [
       {
@@ -244,14 +273,14 @@ function createUserCommandTasks(target) {
 }
 
 // src/core/tasks/copy-dist.ts
-import { resolve as resolve2 } from "path";
+import { resolve as resolve3 } from "path";
 import { rmSync, mkdirSync, cpSync } from "fs";
 import { consola as consola6 } from "consola";
 function createCopyDistTasks(target) {
   const targetCWD = target.targetCWD;
   const outputDirectory = target.outputDirectory;
   function joinPath(dir) {
-    return resolve2(process.cwd(), targetCWD, dir);
+    return resolve3(process.cwd(), targetCWD, dir);
   }
   const pathVercelOutputStatic = joinPath(VERCEL_OUTPUT_STATIC);
   const pathOutputDirectory = joinPath(outputDirectory);
@@ -286,25 +315,31 @@ function createCopyDistTasks(target) {
 }
 
 // src/core/tasks/deploy.ts
+import fs3 from "fs";
+import { resolve as resolve4 } from "path";
 import { spawnSync as spawnSync5 } from "child_process";
 import { concat as concat3 } from "lodash-es";
 import { consola as consola7 } from "consola";
-function createDeployTask(config2, target) {
+function createDeployTask(config, target) {
   return {
     name: `Deploy: ${target.targetCWD}`,
     fn: async () => {
+      const targetPath = resolve4(target.targetCWD);
+      if (!fs3.existsSync(targetPath)) {
+        const err = new Error(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6784\u5EFA: ${target.targetCWD}`);
+        consola7.error(err.message);
+        throw err;
+      }
       const args = concat3(
         ["deploy"],
         ["--yes"],
         ["--prebuilt"],
         ["--prod"],
         getTargetCWDArg(target),
-        getVercelTokenArg(config2)
+        getVercelTokenArg(config)
       );
       consola7.start(`\u5F00\u59CB\u90E8\u7F72\u4EFB\u52A1: ${target.targetCWD}`);
-      const result = spawnSync5("vercel", args, {
-        encoding: "utf-8"
-      });
+      const result = spawnSync5("vercel", args, createVercelSpawnOptions("pipe"));
       if (result.error) {
         consola7.error(`\u90E8\u7F72\u5931\u8D25\u4E86: ${target.targetCWD}`);
         consola7.error(result.error);
@@ -322,16 +357,13 @@ function createDeployTask(config2, target) {
 import { spawnSync as spawnSync6 } from "child_process";
 import { concat as concat4 } from "lodash-es";
 import { consola as consola8 } from "consola";
-function createAliasTask(config2, vercelUrl, userUrl) {
+function createAliasTask(config, vercelUrl, userUrl) {
   return {
     name: `Alias: ${userUrl}`,
     fn: async () => {
-      const args = concat4(["alias", "set", vercelUrl, userUrl], getVercelTokenArg(config2), getVercelScopeArg(config2));
+      const args = concat4(["alias", "set", vercelUrl, userUrl], getVercelTokenArg(config), getVercelScopeArg(config));
       consola8.start(`\u5F00\u59CB\u522B\u540D\u4EFB\u52A1: ${userUrl}`);
-      const result = spawnSync6("vercel", args, {
-        encoding: "utf-8",
-        stdio: "inherit"
-      });
+      const result = spawnSync6("vercel", args, createVercelSpawnOptions());
       if (result.error) {
         consola8.error(`\u522B\u540D\u4EFB\u52A1\u5931\u8D25: ${userUrl}`);
         throw result.error;
@@ -345,19 +377,31 @@ function createAliasTask(config2, vercelUrl, userUrl) {
 
 // src/core/tasks/index.ts
 async function generateVercelNullConfig() {
-  fs.writeFileSync(VERCEL_NULL_CONFIG_PATH, JSON.stringify(VERCEL_NULL_CONFIG, null, 2));
+  fs4.writeFileSync(VERCEL_NULL_CONFIG_PATH, JSON.stringify(VERCEL_NULL_CONFIG, null, 2));
   consola9.success(`\u751F\u6210 Vercel \u7A7A\u914D\u7F6E\u6587\u4EF6: ${VERCEL_NULL_CONFIG_PATH}`);
 }
-async function executeDeploymentWorkflow(config2) {
+async function executeDeploymentWorkflow(config) {
   await generateVercelNullConfig();
-  const { deployTargets } = config2;
+  const { deployTargets } = config;
+  const availableTargets = deployTargets.filter((target) => {
+    const targetPath = resolve5(target.targetCWD);
+    if (!fs4.existsSync(targetPath)) {
+      consola9.warn(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u5DF2\u8DF3\u8FC7: ${target.targetCWD}`);
+      return false;
+    }
+    return true;
+  });
+  if (availableTargets.length === 0) {
+    consola9.error("\u6CA1\u6709\u53EF\u7528\u7684\u90E8\u7F72\u76EE\u6807\uFF0C\u8BF7\u5148\u6784\u5EFA\u4EA7\u7269");
+    return;
+  }
   await task("Vercel \u90E8\u7F72\u5DE5\u4F5C\u6D41", async ({ task: task2 }) => {
     await task2("1. Link \u9879\u76EE", async () => {
-      const linkTasks = deployTargets.map((target) => createLinkTask(config2, target));
+      const linkTasks = availableTargets.map((target) => createLinkTask(config, target));
       await task2.group((task3) => linkTasks.map((t) => task3(t.name, t.fn)));
     });
     await task2("2. \u6784\u5EFA\u9879\u76EE", async () => {
-      const buildTasks = deployTargets.filter(isNeedVercelBuild).map((target) => createBuildTask(config2, target));
+      const buildTasks = availableTargets.filter(isNeedVercelBuild).map((target) => createBuildTask(config, target));
       if (buildTasks.length === 0) {
         consola9.warn("\u6CA1\u6709\u9700\u8981\u6267\u884C build \u7684\u76EE\u6807");
         return;
@@ -365,11 +409,11 @@ async function executeDeploymentWorkflow(config2) {
       await task2.group((task3) => buildTasks.map((t) => task3(t.name, t.fn)));
     });
     await task2("3. \u6267\u884C AfterBuild \u4EFB\u52A1", async () => {
-      const afterBuildTasks = createAfterBuildTasks(config2);
+      const afterBuildTasks = createAfterBuildTasks(config);
       await executeSequential("AfterBuild", afterBuildTasks);
     });
     await task2("4. \u6267\u884C\u7528\u6237\u547D\u4EE4\u4E0E\u6587\u4EF6\u590D\u5236", async () => {
-      const targetTasks = deployTargets.map((target) => ({
+      const targetTasks = availableTargets.map((target) => ({
         name: `\u5904\u7406\u76EE\u6807: ${target.targetCWD}`,
         fn: async () => {
           if (!isDeployTargetWithUserCommands(target)) {
@@ -389,14 +433,14 @@ async function executeDeploymentWorkflow(config2) {
       await task2.group((task3) => targetTasks.map((t) => task3(t.name, t.fn)));
     });
     await task2("5. \u90E8\u7F72\u4E0E\u8BBE\u7F6E\u522B\u540D", async () => {
-      const deployAliasTasks = deployTargets.map((target) => ({
+      const deployAliasTasks = availableTargets.map((target) => ({
         name: `\u90E8\u7F72\u4E0E\u522B\u540D: ${target.targetCWD}`,
         fn: async () => {
-          const deployTask = createDeployTask(config2, target);
+          const deployTask = createDeployTask(config, target);
           const deployResult = await task2(deployTask.name, deployTask.fn);
           const vercelUrl = deployResult.result;
           if (target.url && target.url.length > 0) {
-            const aliasTasks = target.url.map((userUrl) => createAliasTask(config2, vercelUrl, userUrl));
+            const aliasTasks = target.url.map((userUrl) => createAliasTask(config, vercelUrl, userUrl));
             await task2.group((task3) => aliasTasks.map((t) => task3(t.name, t.fn)));
           } else {
             consola9.warn(`\u76EE\u6807 ${target.targetCWD} \u6CA1\u6709\u914D\u7F6E\u522B\u540D`);
@@ -412,12 +456,17 @@ async function executeDeploymentWorkflow(config2) {
 // src/commands/deploy.ts
 function createDeployCommand() {
   const command = new Command("deploy");
-  command.description("\u90E8\u7F72\u9879\u76EE\u5230 Vercel").action(async () => {
+  command.description("\u90E8\u7F72\u9879\u76EE\u5230 Vercel").option("--env-path <path>", "\u6307\u5B9A dotenv \u6587\u4EF6\u8DEF\u5F84\uFF0C\u7528\u4E8E\u8986\u76D6\u9ED8\u8BA4\u73AF\u5883\u53D8\u91CF").action(async (options) => {
     try {
+      if (options?.envPath) {
+        process.env.VERCEL_DEPLOY_TOOL_ENV_PATH = options.envPath;
+        dotenvxConfig2({ path: options.envPath });
+        consola10.info(`\u5DF2\u4ECE --env-path \u52A0\u8F7D\u73AF\u5883\u53D8\u91CF: ${options.envPath}`);
+      }
       consola10.start("\u5F00\u59CB\u52A0\u8F7D\u914D\u7F6E...");
-      const config2 = await loadConfig();
+      const config = await loadConfig();
       consola10.start("\u5F00\u59CB\u6267\u884C\u90E8\u7F72\u5DE5\u4F5C\u6D41...");
-      await executeDeploymentWorkflow(config2);
+      await executeDeploymentWorkflow(config);
       consola10.success("\u90E8\u7F72\u5B8C\u6210\uFF01");
     } catch (error) {
       consola10.error("\u90E8\u7F72\u5931\u8D25:");
@@ -520,4 +569,10 @@ program.on("--help", () => {
   console.log("  VERCEL_PROJECT_ID  - Vercel \u9879\u76EE ID");
   console.log("");
 });
-program.parse();
+async function main() {
+  await program.parseAsync();
+}
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

package/dist/index.d.ts

@@ -112,7 +112,12 @@ declare function defineConfig(config: VercelDeployConfig): VercelDeployConfig;
 /**
  * 异步加载配置（工厂函数模式）
  * @description
- * 从约定俗成的配置处，获得用户配置文件
+ * 从约定俗成的配置处，获得用户配置文件。不会在模块导入时自动执行，避免 top-level await 引起的执行时警告。
+ *
+ * 环境变量优先级：
+ * 1) 命令行传入的 env-path（通过 VERCEL_DEPLOY_TOOL_ENV_PATH 或 deploy 命令参数注入）
+ * 2) Node 进程已有的 process.env
+ * 3) c12 默认加载的 .env* 文件
  *
  * @example
  * ```ts
@@ -121,29 +126,17 @@ declare function defineConfig(config: VercelDeployConfig): VercelDeployConfig;
  */
 declare function loadConfig(): Promise<VercelDeployConfig>;
 /**
- * 默认导出：已初始化的配置实例（top-level await）
- * @description
- * 这是混合模式的一部分，提供默认的配置实例
- *
- * @example
- * ```ts
- * import { config } from "@ruan-cat/vercel-deploy-tool/config/loader";
- * console.log(config.vercelProjectName);
- * ```
- */
-declare const config: VercelDeployConfig;
-/**
- * 导出配置获取函数
+ * 导出配置获取函数（带缓存）
  * @description
- * 获取已加载的配置实例
+ * 首次调用会触发加载，后续复用结果。避免 top-level await。
  *
  * @example
  * ```ts
  * import { getConfig } from "@ruan-cat/vercel-deploy-tool";
- * const config = getConfig();
+ * const config = await getConfig();
  * ```
  */
-declare function getConfig(): VercelDeployConfig;
+declare function getConfig(): Promise<VercelDeployConfig>;
 
 /**
  * 执行 Vercel 部署工作流
@@ -251,4 +244,4 @@ declare function createDeployCommand(): Command;
  */
 declare function createInitCommand(): Command;
 
-export { type DeployTarget, type DeployTargetBase, type DeployTargetType, type DeployTargetWithUserCommands, VERCEL_NULL_CONFIG, VERCEL_NULL_CONFIG_PATH, VERCEL_OUTPUT_STATIC, type VercelDeployConfig, config, createDeployCommand, createInitCommand, defineConfig, executeDeploymentWorkflow, getConfig, getIsCopyDist, isDeployTargetBase, isDeployTargetWithUserCommands, isNeedVercelBuild, loadConfig };
+export { type DeployTarget, type DeployTargetBase, type DeployTargetType, type DeployTargetWithUserCommands, VERCEL_NULL_CONFIG, VERCEL_NULL_CONFIG_PATH, VERCEL_OUTPUT_STATIC, type VercelDeployConfig, createDeployCommand, createInitCommand, defineConfig, executeDeploymentWorkflow, getConfig, getIsCopyDist, isDeployTargetBase, isDeployTargetWithUserCommands, isNeedVercelBuild, loadConfig };

package/dist/index.js

@@ -1,13 +1,13 @@
 // src/config/define-config.ts
-function defineConfig(config2) {
-  return config2;
+function defineConfig(config) {
+  return config;
 }
 
 // src/config/loader.ts
 import { loadConfig as c12LoadConfig } from "c12";
-import { resolve } from "pathe";
 import { consola } from "consola";
 import { isUndefined } from "lodash-es";
+import { config as dotenvxConfig } from "@dotenvx/dotenvx";
 import { printFormat } from "@ruan-cat/utils";
 var CONFIG_NAME = "vercel-deploy-tool";
 var DEFAULT_CONFIG = {
@@ -18,35 +18,47 @@ var DEFAULT_CONFIG = {
   deployTargets: []
 };
 async function loadConfig() {
-  const { config: config2 } = await c12LoadConfig({
-    cwd: resolve("."),
+  consola.start("\u5F00\u59CB\u8BFB\u53D6\u914D\u7F6E\u6587\u4EF6 vercel-deploy-tool.config.* ...");
+  const envPath = process.env.VERCEL_DEPLOY_TOOL_ENV_PATH;
+  if (envPath) {
+    dotenvxConfig({ path: envPath });
+    consola.info(`\u5DF2\u4ECE VERCEL_DEPLOY_TOOL_ENV_PATH \u52A0\u8F7D dotenv: ${envPath}`);
+  }
+  let config;
+  const loaded = await c12LoadConfig({
+    cwd: process.cwd(),
     name: CONFIG_NAME,
     dotenv: true,
     defaults: DEFAULT_CONFIG
   });
+  config = loaded.config;
   const vercelOrgId = process.env.VERCEL_ORG_ID;
   const vercelProjectId = process.env.VERCEL_PROJECT_ID;
   const vercelToken = process.env.VERCEL_TOKEN;
   if (!isUndefined(vercelOrgId)) {
-    config2.vercelOrgId = vercelOrgId;
+    config.vercelOrgId = vercelOrgId;
   }
   if (!isUndefined(vercelProjectId)) {
-    config2.vercelProjectId = vercelProjectId;
+    config.vercelProjectId = vercelProjectId;
   }
   if (!isUndefined(vercelToken)) {
-    config2.vercelToken = vercelToken;
+    config.vercelToken = vercelToken;
   }
   consola.success("\u914D\u7F6E\u52A0\u8F7D\u5B8C\u6210");
-  consola.box(printFormat(config2));
-  return config2;
-}
-var config = await loadConfig();
-function getConfig() {
+  consola.box(printFormat(config));
   return config;
 }
+var cachedConfigPromise = null;
+async function getConfig() {
+  if (!cachedConfigPromise) {
+    cachedConfigPromise = loadConfig();
+  }
+  return cachedConfigPromise;
+}
 
 // src/core/tasks/index.ts
-import fs from "fs";
+import fs4 from "fs";
+import { resolve as resolve5 } from "path";
 import { consola as consola9 } from "consola";
 
 // src/core/executor.ts
@@ -104,19 +116,21 @@ var VERCEL_NULL_CONFIG_PATH = "./vercel.null.def.json";
 var VERCEL_OUTPUT_STATIC = ".vercel/output/static";
 
 // src/core/tasks/link.ts
+import fs from "fs";
+import { resolve } from "path";
 import { spawnSync } from "child_process";
 import { concat } from "lodash-es";
 import { consola as consola2 } from "consola";
 
 // src/core/vercel.ts
-function getVercelProjectNameArg(config2) {
-  return ["--name", config2.vercelProjectName];
+function getVercelProjectNameArg(config) {
+  return ["--project", config.vercelProjectName];
 }
-function getVercelScopeArg(config2) {
-  return ["--scope", config2.vercelOrgId];
+function getVercelScopeArg(config) {
+  return ["--scope", config.vercelOrgId];
 }
-function getVercelTokenArg(config2) {
-  return ["--token", config2.vercelToken];
+function getVercelTokenArg(config) {
+  return ["--token", config.vercelToken];
 }
 function getVercelLocalConfigArg() {
   return ["--local-config", VERCEL_NULL_CONFIG_PATH];
@@ -124,24 +138,37 @@ function getVercelLocalConfigArg() {
 function getTargetCWDArg(target) {
   return ["--cwd", target.targetCWD];
 }
+function createVercelSpawnOptions(stdoutMode = "inherit") {
+  const base = {
+    encoding: "utf8",
+    shell: process.platform === "win32"
+  };
+  if (stdoutMode === "pipe") {
+    return { ...base, stdio: ["inherit", "pipe", "inherit"] };
+  }
+  return { ...base, stdio: "inherit" };
+}
 
 // src/core/tasks/link.ts
-function createLinkTask(config2, target) {
+function createLinkTask(config, target) {
   return {
     name: `Link: ${target.targetCWD}`,
     fn: async () => {
+      const targetPath = resolve(target.targetCWD);
+      if (!fs.existsSync(targetPath)) {
+        const err = new Error(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6784\u5EFA: ${target.targetCWD}`);
+        consola2.error(err.message);
+        throw err;
+      }
       const args = concat(
         ["link"],
         ["--yes"],
         getTargetCWDArg(target),
-        getVercelProjectNameArg(config2),
-        getVercelTokenArg(config2)
+        getVercelProjectNameArg(config),
+        getVercelTokenArg(config)
       );
       consola2.start(`\u5F00\u59CB link \u4EFB\u52A1: ${target.targetCWD}`);
-      const result = spawnSync("vercel", args, {
-        encoding: "utf-8",
-        stdio: "inherit"
-      });
+      const result = spawnSync("vercel", args, createVercelSpawnOptions());
       if (result.error) {
         consola2.error(`link \u4EFB\u52A1\u5931\u8D25: ${target.targetCWD}`);
         throw result.error;
@@ -153,26 +180,31 @@ function createLinkTask(config2, target) {
 }
 
 // src/core/tasks/build.ts
+import fs2 from "fs";
+import { resolve as resolve2 } from "path";
 import { spawnSync as spawnSync2 } from "child_process";
 import { concat as concat2 } from "lodash-es";
 import { consola as consola3 } from "consola";
-function createBuildTask(config2, target) {
+function createBuildTask(config, target) {
   return {
     name: `Build: ${target.targetCWD}`,
     fn: async () => {
+      const targetPath = resolve2(target.targetCWD);
+      if (!fs2.existsSync(targetPath)) {
+        const err = new Error(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6784\u5EFA: ${target.targetCWD}`);
+        consola3.error(err.message);
+        throw err;
+      }
       const args = concat2(
         ["build"],
         ["--yes"],
         ["--prod"],
         getTargetCWDArg(target),
         getVercelLocalConfigArg(),
-        getVercelTokenArg(config2)
+        getVercelTokenArg(config)
       );
       consola3.start(`\u5F00\u59CB build \u4EFB\u52A1: ${target.targetCWD}`);
-      const result = spawnSync2("vercel", args, {
-        encoding: "utf-8",
-        stdio: "inherit"
-      });
+      const result = spawnSync2("vercel", args, createVercelSpawnOptions());
       if (result.error) {
         consola3.error(`build \u4EFB\u52A1\u5931\u8D25: ${target.targetCWD}`);
         throw result.error;
@@ -187,8 +219,8 @@ function createBuildTask(config2, target) {
 import { spawnSync as spawnSync3 } from "child_process";
 import { consola as consola4 } from "consola";
 import { isUndefined as isUndefined2, isEmpty } from "lodash-es";
-function createAfterBuildTasks(config2) {
-  const afterBuildTasks = config2.afterBuildTasks;
+function createAfterBuildTasks(config) {
+  const afterBuildTasks = config.afterBuildTasks;
   if (isUndefined2(afterBuildTasks) || isEmpty(afterBuildTasks)) {
     return [
       {
@@ -243,14 +275,14 @@ function createUserCommandTasks(target) {
 }
 
 // src/core/tasks/copy-dist.ts
-import { resolve as resolve2 } from "path";
+import { resolve as resolve3 } from "path";
 import { rmSync, mkdirSync, cpSync } from "fs";
 import { consola as consola6 } from "consola";
 function createCopyDistTasks(target) {
   const targetCWD = target.targetCWD;
   const outputDirectory = target.outputDirectory;
   function joinPath(dir) {
-    return resolve2(process.cwd(), targetCWD, dir);
+    return resolve3(process.cwd(), targetCWD, dir);
   }
   const pathVercelOutputStatic = joinPath(VERCEL_OUTPUT_STATIC);
   const pathOutputDirectory = joinPath(outputDirectory);
@@ -285,25 +317,31 @@ function createCopyDistTasks(target) {
 }
 
 // src/core/tasks/deploy.ts
+import fs3 from "fs";
+import { resolve as resolve4 } from "path";
 import { spawnSync as spawnSync5 } from "child_process";
 import { concat as concat3 } from "lodash-es";
 import { consola as consola7 } from "consola";
-function createDeployTask(config2, target) {
+function createDeployTask(config, target) {
   return {
     name: `Deploy: ${target.targetCWD}`,
     fn: async () => {
+      const targetPath = resolve4(target.targetCWD);
+      if (!fs3.existsSync(targetPath)) {
+        const err = new Error(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u8BF7\u5148\u6784\u5EFA: ${target.targetCWD}`);
+        consola7.error(err.message);
+        throw err;
+      }
       const args = concat3(
         ["deploy"],
         ["--yes"],
         ["--prebuilt"],
         ["--prod"],
         getTargetCWDArg(target),
-        getVercelTokenArg(config2)
+        getVercelTokenArg(config)
       );
       consola7.start(`\u5F00\u59CB\u90E8\u7F72\u4EFB\u52A1: ${target.targetCWD}`);
-      const result = spawnSync5("vercel", args, {
-        encoding: "utf-8"
-      });
+      const result = spawnSync5("vercel", args, createVercelSpawnOptions("pipe"));
       if (result.error) {
         consola7.error(`\u90E8\u7F72\u5931\u8D25\u4E86: ${target.targetCWD}`);
         consola7.error(result.error);
@@ -321,16 +359,13 @@ function createDeployTask(config2, target) {
 import { spawnSync as spawnSync6 } from "child_process";
 import { concat as concat4 } from "lodash-es";
 import { consola as consola8 } from "consola";
-function createAliasTask(config2, vercelUrl, userUrl) {
+function createAliasTask(config, vercelUrl, userUrl) {
   return {
     name: `Alias: ${userUrl}`,
     fn: async () => {
-      const args = concat4(["alias", "set", vercelUrl, userUrl], getVercelTokenArg(config2), getVercelScopeArg(config2));
+      const args = concat4(["alias", "set", vercelUrl, userUrl], getVercelTokenArg(config), getVercelScopeArg(config));
       consola8.start(`\u5F00\u59CB\u522B\u540D\u4EFB\u52A1: ${userUrl}`);
-      const result = spawnSync6("vercel", args, {
-        encoding: "utf-8",
-        stdio: "inherit"
-      });
+      const result = spawnSync6("vercel", args, createVercelSpawnOptions());
       if (result.error) {
         consola8.error(`\u522B\u540D\u4EFB\u52A1\u5931\u8D25: ${userUrl}`);
         throw result.error;
@@ -344,19 +379,31 @@ function createAliasTask(config2, vercelUrl, userUrl) {
 
 // src/core/tasks/index.ts
 async function generateVercelNullConfig() {
-  fs.writeFileSync(VERCEL_NULL_CONFIG_PATH, JSON.stringify(VERCEL_NULL_CONFIG, null, 2));
+  fs4.writeFileSync(VERCEL_NULL_CONFIG_PATH, JSON.stringify(VERCEL_NULL_CONFIG, null, 2));
   consola9.success(`\u751F\u6210 Vercel \u7A7A\u914D\u7F6E\u6587\u4EF6: ${VERCEL_NULL_CONFIG_PATH}`);
 }
-async function executeDeploymentWorkflow(config2) {
+async function executeDeploymentWorkflow(config) {
   await generateVercelNullConfig();
-  const { deployTargets } = config2;
+  const { deployTargets } = config;
+  const availableTargets = deployTargets.filter((target) => {
+    const targetPath = resolve5(target.targetCWD);
+    if (!fs4.existsSync(targetPath)) {
+      consola9.warn(`\u76EE\u6807\u76EE\u5F55\u4E0D\u5B58\u5728\uFF0C\u5DF2\u8DF3\u8FC7: ${target.targetCWD}`);
+      return false;
+    }
+    return true;
+  });
+  if (availableTargets.length === 0) {
+    consola9.error("\u6CA1\u6709\u53EF\u7528\u7684\u90E8\u7F72\u76EE\u6807\uFF0C\u8BF7\u5148\u6784\u5EFA\u4EA7\u7269");
+    return;
+  }
   await task("Vercel \u90E8\u7F72\u5DE5\u4F5C\u6D41", async ({ task: task2 }) => {
     await task2("1. Link \u9879\u76EE", async () => {
-      const linkTasks = deployTargets.map((target) => createLinkTask(config2, target));
+      const linkTasks = availableTargets.map((target) => createLinkTask(config, target));
       await task2.group((task3) => linkTasks.map((t) => task3(t.name, t.fn)));
     });
     await task2("2. \u6784\u5EFA\u9879\u76EE", async () => {
-      const buildTasks = deployTargets.filter(isNeedVercelBuild).map((target) => createBuildTask(config2, target));
+      const buildTasks = availableTargets.filter(isNeedVercelBuild).map((target) => createBuildTask(config, target));
       if (buildTasks.length === 0) {
         consola9.warn("\u6CA1\u6709\u9700\u8981\u6267\u884C build \u7684\u76EE\u6807");
         return;
@@ -364,11 +411,11 @@ async function executeDeploymentWorkflow(config2) {
       await task2.group((task3) => buildTasks.map((t) => task3(t.name, t.fn)));
     });
     await task2("3. \u6267\u884C AfterBuild \u4EFB\u52A1", async () => {
-      const afterBuildTasks = createAfterBuildTasks(config2);
+      const afterBuildTasks = createAfterBuildTasks(config);
       await executeSequential("AfterBuild", afterBuildTasks);
     });
     await task2("4. \u6267\u884C\u7528\u6237\u547D\u4EE4\u4E0E\u6587\u4EF6\u590D\u5236", async () => {
-      const targetTasks = deployTargets.map((target) => ({
+      const targetTasks = availableTargets.map((target) => ({
         name: `\u5904\u7406\u76EE\u6807: ${target.targetCWD}`,
         fn: async () => {
           if (!isDeployTargetWithUserCommands(target)) {
@@ -388,14 +435,14 @@ async function executeDeploymentWorkflow(config2) {
       await task2.group((task3) => targetTasks.map((t) => task3(t.name, t.fn)));
     });
     await task2("5. \u90E8\u7F72\u4E0E\u8BBE\u7F6E\u522B\u540D", async () => {
-      const deployAliasTasks = deployTargets.map((target) => ({
+      const deployAliasTasks = availableTargets.map((target) => ({
         name: `\u90E8\u7F72\u4E0E\u522B\u540D: ${target.targetCWD}`,
         fn: async () => {
-          const deployTask = createDeployTask(config2, target);
+          const deployTask = createDeployTask(config, target);
           const deployResult = await task2(deployTask.name, deployTask.fn);
           const vercelUrl = deployResult.result;
           if (target.url && target.url.length > 0) {
-            const aliasTasks = target.url.map((userUrl) => createAliasTask(config2, vercelUrl, userUrl));
+            const aliasTasks = target.url.map((userUrl) => createAliasTask(config, vercelUrl, userUrl));
             await task2.group((task3) => aliasTasks.map((t) => task3(t.name, t.fn)));
           } else {
             consola9.warn(`\u76EE\u6807 ${target.targetCWD} \u6CA1\u6709\u914D\u7F6E\u522B\u540D`);
@@ -411,14 +458,20 @@ async function executeDeploymentWorkflow(config2) {
 // src/commands/deploy.ts
 import { Command } from "commander";
 import { consola as consola10 } from "consola";
+import { config as dotenvxConfig2 } from "@dotenvx/dotenvx";
 function createDeployCommand() {
   const command = new Command("deploy");
-  command.description("\u90E8\u7F72\u9879\u76EE\u5230 Vercel").action(async () => {
+  command.description("\u90E8\u7F72\u9879\u76EE\u5230 Vercel").option("--env-path <path>", "\u6307\u5B9A dotenv \u6587\u4EF6\u8DEF\u5F84\uFF0C\u7528\u4E8E\u8986\u76D6\u9ED8\u8BA4\u73AF\u5883\u53D8\u91CF").action(async (options) => {
     try {
+      if (options?.envPath) {
+        process.env.VERCEL_DEPLOY_TOOL_ENV_PATH = options.envPath;
+        dotenvxConfig2({ path: options.envPath });
+        consola10.info(`\u5DF2\u4ECE --env-path \u52A0\u8F7D\u73AF\u5883\u53D8\u91CF: ${options.envPath}`);
+      }
       consola10.start("\u5F00\u59CB\u52A0\u8F7D\u914D\u7F6E...");
-      const config2 = await loadConfig();
+      const config = await loadConfig();
       consola10.start("\u5F00\u59CB\u6267\u884C\u90E8\u7F72\u5DE5\u4F5C\u6D41...");
-      await executeDeploymentWorkflow(config2);
+      await executeDeploymentWorkflow(config);
       consola10.success("\u90E8\u7F72\u5B8C\u6210\uFF01");
     } catch (error) {
       consola10.error("\u90E8\u7F72\u5931\u8D25:");
@@ -492,7 +545,6 @@ export {
   VERCEL_NULL_CONFIG,
   VERCEL_NULL_CONFIG_PATH,
   VERCEL_OUTPUT_STATIC,
-  config,
   createDeployCommand,
   createInitCommand,
   defineConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruan-cat/vercel-deploy-tool",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "阮喵喵自用的vercel部署工具，用于实现复杂项目的部署。",
   "type": "module",
   "main": "./dist/index.js",

package/src/cli.ts

@@ -50,5 +50,12 @@ program.on("--help", () => {
 	console.log("");
 });
 
-// 解析命令行参数
-program.parse();
+async function main() {
+	// 解析命令行参数（异步，确保子命令的 async action 被执行并正确传递异常）
+	await program.parseAsync();
+}
+
+main().catch((error) => {
+	console.error(error);
+	process.exit(1);
+});

package/src/commands/deploy.ts

@@ -1,5 +1,6 @@
 import { Command } from "commander";
 import { consola } from "consola";
+import { config as dotenvxConfig } from "@dotenvx/dotenvx";
 import { loadConfig } from "../config/loader";
 import { executeDeploymentWorkflow } from "../core/tasks";
 
@@ -17,23 +18,33 @@ import { executeDeploymentWorkflow } from "../core/tasks";
 export function createDeployCommand(): Command {
 	const command = new Command("deploy");
 
-	command.description("部署项目到 Vercel").action(async () => {
-		try {
-			consola.start("开始加载配置...");
+	command
+		.description("部署项目到 Vercel")
+		.option("--env-path <path>", "指定 dotenv 文件路径，用于覆盖默认环境变量")
+		.action(async (options) => {
+			try {
+				// 允许部署时显式指定 env 文件
+				if (options?.envPath) {
+					process.env.VERCEL_DEPLOY_TOOL_ENV_PATH = options.envPath;
+					dotenvxConfig({ path: options.envPath });
+					consola.info(`已从 --env-path 加载环境变量: ${options.envPath}`);
+				}
 
-			const config = await loadConfig();
+				consola.start("开始加载配置...");
 
-			consola.start("开始执行部署工作流...");
+				const config = await loadConfig();
 
-			await executeDeploymentWorkflow(config);
+				consola.start("开始执行部署工作流...");
 
-			consola.success("部署完成！");
-		} catch (error) {
-			consola.error("部署失败:");
-			consola.error(error);
-			process.exit(1);
-		}
-	});
+				await executeDeploymentWorkflow(config);
+
+				consola.success("部署完成！");
+			} catch (error) {
+				consola.error("部署失败:");
+				consola.error(error);
+				process.exit(1);
+			}
+		});
 
 	return command;
 }

package/src/config/loader.ts

@@ -1,7 +1,7 @@
 import { loadConfig as c12LoadConfig } from "c12";
-import { resolve } from "pathe";
 import { consola } from "consola";
 import { isUndefined } from "lodash-es";
+import { config as dotenvxConfig } from "@dotenvx/dotenvx";
 import { printFormat } from "@ruan-cat/utils";
 import type { VercelDeployConfig } from "./schema";
 
@@ -20,7 +20,12 @@ const DEFAULT_CONFIG: VercelDeployConfig = {
 /**
  * 异步加载配置（工厂函数模式）
  * @description
- * 从约定俗成的配置处，获得用户配置文件
+ * 从约定俗成的配置处，获得用户配置文件。不会在模块导入时自动执行，避免 top-level await 引起的执行时警告。
+ *
+ * 环境变量优先级：
+ * 1) 命令行传入的 env-path（通过 VERCEL_DEPLOY_TOOL_ENV_PATH 或 deploy 命令参数注入）
+ * 2) Node 进程已有的 process.env
+ * 3) c12 默认加载的 .env* 文件
  *
  * @example
  * ```ts
@@ -28,13 +33,26 @@ const DEFAULT_CONFIG: VercelDeployConfig = {
  * ```
  */
 export async function loadConfig(): Promise<VercelDeployConfig> {
-	const { config } = await c12LoadConfig<VercelDeployConfig>({
-		cwd: resolve("."),
+	consola.start("开始读取配置文件 vercel-deploy-tool.config.* ...");
+
+	// 兼容 CLI 的 --env-path，允许指定自定义 dotenv 文件
+	const envPath = process.env.VERCEL_DEPLOY_TOOL_ENV_PATH;
+	if (envPath) {
+		dotenvxConfig({ path: envPath });
+		consola.info(`已从 VERCEL_DEPLOY_TOOL_ENV_PATH 加载 dotenv: ${envPath}`);
+	}
+
+	let config: VercelDeployConfig | undefined;
+
+	const loaded = await c12LoadConfig<VercelDeployConfig>({
+		cwd: process.cwd(),
 		name: CONFIG_NAME,
 		dotenv: true,
 		defaults: DEFAULT_CONFIG,
 	});
 
+	config = loaded.config;
+
 	// 环境变量覆盖
 	const vercelOrgId = process.env.VERCEL_ORG_ID;
 	const vercelProjectId = process.env.VERCEL_PROJECT_ID;
@@ -56,30 +74,22 @@ export async function loadConfig(): Promise<VercelDeployConfig> {
 	return config;
 }
 
-/**
- * 默认导出：已初始化的配置实例（top-level await）
- * @description
- * 这是混合模式的一部分，提供默认的配置实例
- *
- * @example
- * ```ts
- * import { config } from "@ruan-cat/vercel-deploy-tool/config/loader";
- * console.log(config.vercelProjectName);
- * ```
- */
-export const config = await loadConfig();
+let cachedConfigPromise: Promise<VercelDeployConfig> | null = null;
 
 /**
- * 导出配置获取函数
+ * 导出配置获取函数（带缓存）
  * @description
- * 获取已加载的配置实例
+ * 首次调用会触发加载，后续复用结果。避免 top-level await。
  *
  * @example
  * ```ts
  * import { getConfig } from "@ruan-cat/vercel-deploy-tool";
- * const config = getConfig();
+ * const config = await getConfig();
  * ```
  */
-export function getConfig(): VercelDeployConfig {
-	return config;
+export async function getConfig(): Promise<VercelDeployConfig> {
+	if (!cachedConfigPromise) {
+		cachedConfigPromise = loadConfig();
+	}
+	return cachedConfigPromise;
 }

package/src/core/tasks/alias.ts

@@ -2,7 +2,7 @@ import { spawnSync } from "node:child_process";
 import { concat } from "lodash-es";
 import { consola } from "consola";
 import type { VercelDeployConfig } from "../../config/schema";
-import { getVercelTokenArg, getVercelScopeArg } from "../vercel";
+import { createVercelSpawnOptions, getVercelTokenArg, getVercelScopeArg } from "../vercel";
 
 /**
  * 创建 Alias 任务
@@ -21,10 +21,7 @@ export function createAliasTask(config: VercelDeployConfig, vercelUrl: string, u
 
 			consola.start(`开始别名任务: ${userUrl}`);
 
-			const result = spawnSync("vercel", args, {
-				encoding: "utf-8",
-				stdio: "inherit",
-			});
+			const result = spawnSync("vercel", args, createVercelSpawnOptions());
 
 			if (result.error) {
 				consola.error(`别名任务失败: ${userUrl}`);

package/src/core/tasks/build.ts

@@ -1,8 +1,10 @@
+import fs from "node:fs";
+import { resolve } from "node:path";
 import { spawnSync } from "node:child_process";
 import { concat } from "lodash-es";
 import { consola } from "consola";
 import type { VercelDeployConfig, DeployTarget } from "../../config/schema";
-import { getVercelTokenArg, getVercelLocalConfigArg, getTargetCWDArg } from "../vercel";
+import { createVercelSpawnOptions, getVercelTokenArg, getVercelLocalConfigArg, getTargetCWDArg } from "../vercel";
 
 /**
  * 创建 Build 任务
@@ -15,6 +17,14 @@ export function createBuildTask(config: VercelDeployConfig, target: DeployTarget
 	return {
 		name: `Build: ${target.targetCWD}`,
 		fn: async () => {
+			const targetPath = resolve(target.targetCWD);
+
+			if (!fs.existsSync(targetPath)) {
+				const err = new Error(`目标目录不存在，请先构建: ${target.targetCWD}`);
+				consola.error(err.message);
+				throw err;
+			}
+
 			const args = concat(
 				["build"],
 				["--yes"],
@@ -26,10 +36,7 @@ export function createBuildTask(config: VercelDeployConfig, target: DeployTarget
 
 			consola.start(`开始 build 任务: ${target.targetCWD}`);
 
-			const result = spawnSync("vercel", args, {
-				encoding: "utf-8",
-				stdio: "inherit",
-			});
+			const result = spawnSync("vercel", args, createVercelSpawnOptions());
 
 			if (result.error) {
 				consola.error(`build 任务失败: ${target.targetCWD}`);

package/src/core/tasks/deploy.ts

@@ -1,8 +1,10 @@
+import fs from "node:fs";
+import { resolve } from "node:path";
 import { spawnSync } from "node:child_process";
 import { concat } from "lodash-es";
 import { consola } from "consola";
 import type { VercelDeployConfig, DeployTarget } from "../../config/schema";
-import { getVercelTokenArg, getTargetCWDArg } from "../vercel";
+import { createVercelSpawnOptions, getVercelTokenArg, getTargetCWDArg } from "../vercel";
 
 /**
  * 创建 Deploy 任务
@@ -15,6 +17,14 @@ export function createDeployTask(config: VercelDeployConfig, target: DeployTarge
 	return {
 		name: `Deploy: ${target.targetCWD}`,
 		fn: async () => {
+			const targetPath = resolve(target.targetCWD);
+
+			if (!fs.existsSync(targetPath)) {
+				const err = new Error(`目标目录不存在，请先构建: ${target.targetCWD}`);
+				consola.error(err.message);
+				throw err;
+			}
+
 			const args = concat(
 				["deploy"],
 				["--yes"],
@@ -26,9 +36,7 @@ export function createDeployTask(config: VercelDeployConfig, target: DeployTarge
 
 			consola.start(`开始部署任务: ${target.targetCWD}`);
 
-			const result = spawnSync("vercel", args, {
-				encoding: "utf-8",
-			});
+			const result = spawnSync("vercel", args, createVercelSpawnOptions("pipe"));
 
 			if (result.error) {
 				consola.error(`部署失败了: ${target.targetCWD}`);

package/src/core/tasks/index.ts

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import { resolve } from "node:path";
 import { consola } from "consola";
 import { task, executeSequential } from "../executor";
 import type { VercelDeployConfig } from "../../config/schema";
@@ -40,17 +41,34 @@ export async function executeDeploymentWorkflow(config: VercelDeployConfig) {
 
 	const { deployTargets } = config;
 
+	// 过滤不存在的目标目录，避免后续 Vercel CLI 抛出 ENOENT
+	const availableTargets = deployTargets.filter((target) => {
+		const targetPath = resolve(target.targetCWD);
+
+		if (!fs.existsSync(targetPath)) {
+			consola.warn(`目标目录不存在，已跳过: ${target.targetCWD}`);
+			return false;
+		}
+
+		return true;
+	});
+
+	if (availableTargets.length === 0) {
+		consola.error("没有可用的部署目标，请先构建产物");
+		return;
+	}
+
 	await task("Vercel 部署工作流", async ({ task }) => {
 		// 1. Link 阶段（并行）
 		await task("1. Link 项目", async () => {
-			const linkTasks = deployTargets.map((target) => createLinkTask(config, target));
+			const linkTasks = availableTargets.map((target) => createLinkTask(config, target));
 
 			await task.group((task) => linkTasks.map((t) => task(t.name, t.fn)));
 		});
 
 		// 2. Build 阶段（并行）
 		await task("2. 构建项目", async () => {
-			const buildTasks = deployTargets.filter(isNeedVercelBuild).map((target) => createBuildTask(config, target));
+			const buildTasks = availableTargets.filter(isNeedVercelBuild).map((target) => createBuildTask(config, target));
 
 			if (buildTasks.length === 0) {
 				consola.warn("没有需要执行 build 的目标");
@@ -69,7 +87,7 @@ export async function executeDeploymentWorkflow(config: VercelDeployConfig) {
 
 		// 4. UserCommands + CopyDist 阶段（并行目标，串行步骤）
 		await task("4. 执行用户命令与文件复制", async () => {
-			const targetTasks = deployTargets.map((target) => ({
+			const targetTasks = availableTargets.map((target) => ({
 				name: `处理目标: ${target.targetCWD}`,
 				fn: async () => {
 					// 如果不是 userCommands 类型，跳过
@@ -98,7 +116,7 @@ export async function executeDeploymentWorkflow(config: VercelDeployConfig) {
 
 		// 5. Deploy + Alias 阶段（并行目标，串行步骤）
 		await task("5. 部署与设置别名", async () => {
-			const deployAliasTasks = deployTargets.map((target) => ({
+			const deployAliasTasks = availableTargets.map((target) => ({
 				name: `部署与别名: ${target.targetCWD}`,
 				fn: async () => {
 					// 5.1 部署

package/src/core/tasks/link.ts

@@ -1,8 +1,10 @@
+import fs from "node:fs";
+import { resolve } from "node:path";
 import { spawnSync } from "node:child_process";
 import { concat } from "lodash-es";
 import { consola } from "consola";
 import type { VercelDeployConfig, DeployTarget } from "../../config/schema";
-import { getVercelProjectNameArg, getVercelTokenArg, getTargetCWDArg } from "../vercel";
+import { createVercelSpawnOptions, getVercelProjectNameArg, getVercelTokenArg, getTargetCWDArg } from "../vercel";
 
 /**
  * 创建 Link 任务
@@ -15,6 +17,14 @@ export function createLinkTask(config: VercelDeployConfig, target: DeployTarget)
 	return {
 		name: `Link: ${target.targetCWD}`,
 		fn: async () => {
+			const targetPath = resolve(target.targetCWD);
+
+			if (!fs.existsSync(targetPath)) {
+				const err = new Error(`目标目录不存在，请先构建: ${target.targetCWD}`);
+				consola.error(err.message);
+				throw err;
+			}
+
 			const args = concat(
 				["link"],
 				["--yes"],
@@ -25,10 +35,7 @@ export function createLinkTask(config: VercelDeployConfig, target: DeployTarget)
 
 			consola.start(`开始 link 任务: ${target.targetCWD}`);
 
-			const result = spawnSync("vercel", args, {
-				encoding: "utf-8",
-				stdio: "inherit",
-			});
+			const result = spawnSync("vercel", args, createVercelSpawnOptions());
 
 			if (result.error) {
 				consola.error(`link 任务失败: ${target.targetCWD}`);

package/src/core/vercel.ts

@@ -1,11 +1,12 @@
 import type { VercelDeployConfig, DeployTarget } from "../config/schema";
 import { VERCEL_NULL_CONFIG_PATH } from "../utils/vercel-null-config";
+import type { SpawnSyncOptions } from "node:child_process";
 
 /**
  * 获取 Vercel 项目名称参数
  */
 export function getVercelProjectNameArg(config: VercelDeployConfig): string[] {
-	return ["--name", config.vercelProjectName];
+	return ["--project", config.vercelProjectName];
 }
 
 /**
@@ -35,3 +36,20 @@ export function getVercelLocalConfigArg(): string[] {
 export function getTargetCWDArg(target: DeployTarget): string[] {
 	return ["--cwd", target.targetCWD];
 }
+
+/**
+ * 统一的 Vercel CLI spawn 配置
+ * @param stdoutMode stdout 行为，默认继承终端；需要读取 stdout 时传入 "pipe"
+ */
+export function createVercelSpawnOptions(stdoutMode: "inherit" | "pipe" = "inherit"): SpawnSyncOptions {
+	const base: SpawnSyncOptions = {
+		encoding: "utf8",
+		shell: process.platform === "win32",
+	};
+
+	if (stdoutMode === "pipe") {
+		return { ...base, stdio: ["inherit", "pipe", "inherit"] };
+	}
+
+	return { ...base, stdio: "inherit" };
+}

package/src/index.ts

@@ -39,7 +39,7 @@ export { defineConfig } from "./config/define-config";
  * const config = await loadConfig();
  * ```
  */
-export { loadConfig, getConfig, config } from "./config/loader";
+export { loadConfig, getConfig } from "./config/loader";
 
 // ==================== 类型定义 ====================