Vercel CLI无法读取指定配置文件，--local-config参数失效求助

你的操作误区 #

--local-config（或简写-A）参数仅适用于vercel dev本地开发命令，vercel build和vercel deploy --prebuilt并不支持通过该参数加载自定义配置文件，它们默认只会读取项目根目录下的vercel.json，这就是你指定配置文件被忽略的核心原因。

多分支自定义 buildCommand 的正确方案 #

方案1：通过主 vercel.json 配置分支规则 #

直接在根目录的vercel.json中定义分支对应的构建命令，Vercel 会自动根据当前部署分支匹配执行：

{
  "buildCommand": "yarn build:dev", // 默认分支（如dev）的构建命令
  "build": {
    "branches": {
      "main": {
        "buildCommand": "yarn build:prod" // main分支用生产构建命令
      },
      "staging": {
        "buildCommand": "yarn build:staging" // staging分支用预发布构建命令
      }
    }
  }
}

本地构建时若要模拟指定分支环境，可结合环境变量：

# 模拟main分支构建
VERCEL_ENV=production vercel build
# 然后部署预构建产物
vercel deploy --prebuilt --prod

方案2：本地构建时用环境变量覆盖 buildCommand #

无需额外配置文件，直接通过环境变量临时指定构建命令，优先级高于vercel.json中的配置：

# 开发分支构建
VERCEL_BUILD_COMMAND="yarn build:dev" vercel build
# 生产分支构建
VERCEL_BUILD_COMMAND="yarn build:prod" vercel build
# 部署预构建产物
vercel deploy --prebuilt

方案3：结合项目环境变量与 package.json 脚本 #

在 Vercel 网页端项目设置中，给不同分支配置专属的环境变量（比如给main分支设BUILD_ENV=prod，dev分支设BUILD_ENV=dev），然后在package.json中写条件判断脚本：

{
  "scripts": {
    "build": "if [ \"$BUILD_ENV\" = \"prod\" ]; then yarn build:prod; else yarn build:dev; fi"
  }
}

最后把vercel.json中的buildCommand设为yarn build即可，本地构建时也可通过设置BUILD_ENV变量模拟对应环境。

内容的提问来源于stack exchange，提问作者Oleksii Shnyra