vscode vercel插件deploy没反应或卡住，主因是未安装vercel cli、未在项目根目录登录，或vercel.json配置错误；插件仅触发命令和跳转页面，不实时监控构建状态。
VSCode 里点 Vercel 插件的 Deploy 没反应，或者部署后卡在 “Building” 不动、状态不更新——这不是插件坏了，而是它根本没设计成“实时监控器”。它只负责触发命令和跳转页面，构建日志和状态轮询得靠你自己手动刷，或换别的办法。
vercel 命令在 VSCode 终端里报 command not found
插件底层全靠全局 vercel 命令驱动，没装 CLI 就等于没引擎。别怪插件，先看终端能不能跑通命令：
- 运行
npm install -g vercel（或yarn global add vercel）装 CLI - 验证：执行
vercel --version，有输出才算成功 - 如果仍报错
command not found，关掉所有 VSCode 窗口，**从系统终端（macOS/Linux）或 PowerShell（Windows）重新打开 VSCode**——快捷方式启动时不会继承 shell 的$PATH - Windows 用户若用 Git Bash，
vercel常不可用，换 Windows Terminal + PowerShell 或 CMD
VSCode Vercel 插件点 Deploy 没反应或灰掉
插件不是智能发现器，它只认两个硬条件：项目根目录 + 已登录。缺一不可：
- 确认 VSCode 当前打开的是**项目根目录**（含
package.json或vercel.json），不是子文件夹 - 右下角状态栏必须显示
Logged in as xxx；没登录就先在终端跑vercel login - 首次部署选错 Team（比如该选团队却点了个人账号），后续
vercel --prod会失败；删掉项目根下的.vercel/project.json重来 - 禁用已停更的
zeit-now插件，只用官方Vercel扩展（发布者是 Vercel）
部署后状态卡住、日志看不到、404 频发
Vercel 插件不拉日志、不轮询状态、不解析错误原因。它只管“点一下，开个网页”，剩下的得你盯：
- 点击插件里的 job 名称，会跳转到 GitHub/Vercel 页面查看完整日志——**日志不在 VSCode 里流式输出**
- 页面 404 或资源加载失败？90% 是
outputDirectory没对上：React/Vite 默认输出dist，但 Vercel 自动探测可能误判为build；显式写{"outputDirectory": "dist"}到vercel.json -
vercel.json必须放在项目根目录，字段名大小写敏感（如rewrites写成ReWrites就失效）；builds字段已废弃，改用functions或overrides - 插件里点刷新按钮（↻）才查一次状态，不会自动轮询；状态可能卡在
in_progress几分钟，直到你手动刷新
想真“实时”看构建状态？别依赖插件 UI
GitHub Actions 官方 VSCode 扩展（github.vscode-github-actions）同样不轮询、不推通知、不流日志。所谓“实时”是误解：
- 它调用的是 REST API
/actions/runs，默认无定时请求，全靠你点刷新 - 要近实时（比如每 15 秒查一次），得自己写轻量扩展：用
@octokit/rest调listWorkflowRuns，配合setTimeout递归轮询，且首次延迟 3 秒防抖 - 更省事的做法：用
gh run watch（ghCLI），它原生支持流式日志和自动刷新，比任何 VSCode 插件都可靠
插件只是快捷入口，不是构建监控终端。真正影响部署成败的，是 CLI 是否就位、配置是否放对位置、输出路径是否明确——这些细节漏一个，状态就卡死，而插件连报错都不会告诉你。
