VSCode中Deploy无响应或报command not found: vercel，根本原因是未全局安装Vercel CLI或PATH未配置；vercel.json须置于根目录、字段大小写敏感、builds已废弃；部署404多因outputDirectory未设或缓存未清。
VSCode 里点 Deploy 没反应、命令报 command not found: vercel、部署后 404——根本不是插件问题，是 CLI 没装好或配置没对齐。
vercel 命令在 VSCode 终端里找不到？先确认 CLI 是否真正可用
VSCode 插件只是调用底层 vercel 命令的图形界面，它不自带 CLI。终端报错 command not found: vercel，说明系统根本没装，或装了但路径没进 VSCode 的环境变量。
- 必须先执行
npm install -g vercel（或yarn global add vercel），再运行vercel --version验证输出版本号 - Windows 用户若用 Git Bash，
vercel往往不可用——换用 Windows Terminal 中的 PowerShell 或 CMD - macOS/Linux 用户装完仍报错，大概率是 Node.js 全局 bin 路径（如
~/.npm-global/bin）没写进 VSCode 启动时的$PATH：关掉所有 VSCode 窗口，从系统终端（不是 Dock 快捷方式）重新打开
vercel.json 配置无效？字段名、位置、废弃字段全要核对
vercel.json 必须放在项目根目录（和 package.json 同级），且文件名不能是 vercel.config.json（那是旧版写法，已不识别）。字段大小写敏感，且部分字段已被弃用。
-
builds字段已废弃，现在用functions或overrides替代；如果还保留"builds": [{ "src": "*.js", "use": "@vercel/node" }]，函数构建会静默跳过 - 路由重写必须用
rewrites数组，每项含source和destination，写成from/to或漏掉source都不生效，例如：{"source": "/api/(.*)", "destination": "/api/index.js"} - 配置优先级：项目根
vercel.json> Vercel 项目控制台设置 > 默认自动检测；改了配置后记得清缓存或加--force重试
VSCode 插件 Deploy 按钮灰掉或无响应？检查两个硬性前提
插件不会主动识别子目录里的项目，也不会帮你登录账号——它只在满足两个条件时才激活：
- VSCode 当前打开的是**项目根目录**（即包含
package.json或vercel.json的文件夹），不是src/或client/这类子目录 - 终端里已执行过
vercel login完成认证；插件右下角状态栏显示Not logged in?就说明没链上账号 - 首次部署选错 Team（比如该用团队账号却选了个人账号），后续
vercel --prod会失败，只能删掉.vercel/project.json重来
部署后页面 404？重点查 outputDirectory 和构建产物路径
Vercel 默认会尝试自动检测框架和输出目录（如 Next.js → .next，Vite → dist），但一旦项目结构非标准，就容易找错入口或静态文件位置。
- 本地构建产物是否真生成了？运行
npm run build（或对应命令）确认dist/.next/out目录存在且含 HTML 文件 - 在 Vercel 控制台或
vercel.json中显式指定outputDirectory，例如："outputDirectory": "dist"；不写可能 fallback 到空目录 - 如果是单页应用（SPA），需配
rewrites把所有前端路由 fallback 到index.html，否则子路径刷新直接 404
最常被忽略的其实是「VSCode 启动方式」和「vercel.json 字段大小写」——前者导致 CLI 找不到，后者让整个配置静默失效，连错误提示都没有。
