vscode中vercel命令失败需先全局安装cli并配置path；vercel.json须置于根目录、字段名大小写敏感、builds已废弃；插件deploy无效需确认项目根目录和登录状态；部署404多因outputdirectory未正确设置或缓存未清除。
vscode里直接运行vercel命令失败？先装CLI再配PATH
VSCode终端报错 command not found: vercel，不是插件问题，是本地根本没装Vercel CLI。插件只是界面包装，底层依赖全局vercel命令。
- 必须先在终端执行
npm install -g vercel（或用yarn global add vercel），装完验证：vercel --version - 如果装了还报错，大概率是Node.js的全局bin路径没进VSCode的
$PATH——关掉所有VSCode窗口，从系统终端（macOS/Linux）或PowerShell（Windows）重新打开VSCode，别用dock/开始菜单快捷方式启动 - Windows用户用Git Bash时，
vercel可能不可用，换用Windows Terminal里的PowerShell或CMD
vercel.json配置不生效？优先级和字段名容易写错
vercel.json里写的配置，比如rewrites或headers，常被忽略，因为Vercel会按固定顺序合并多处配置，且字段名大小写敏感。
- 根目录放
vercel.json才有效；放在子目录或改名成vercel.config.json（旧版写法）会被忽略 -
builds字段已废弃，现在用functions或overrides替代；若还写"builds": [{ "src": "*.js", "use": "@vercel/node" }]，部署会静默跳过函数构建 - 路由重写必须写全路径：
{"source": "/api/(.*)", "destination": "/api/index.js"}，漏掉source或写成from/to都不起作用
VSCode插件“Vercel”点Deploy没反应？检查项目根和登录状态
插件界面上的Deploy按钮灰掉或点击无反馈，通常卡在两个地方：项目没识别为Vercel项目，或账号没链上。
- 确保VSCode当前打开的是**项目根目录**（含
package.json或vercel.json），不是子文件夹——插件不会递归找配置 - 插件右下角状态栏显示
Not logged in？必须先在终端运行vercel login完成认证，插件不提供独立登录流程 - 首次部署时插件会弹窗让你选Team，选错后不能改——如果选了个人账号但项目属于Team，后续
vercel --prod会失败，得删掉.vercel/project.json重来
部署后页面404或静态资源加载失败？public目录和输出路径对不上
React/Vue项目build后页面空白、CSS/JS 404，90%是因为Vercel没找到正确输出目录，或者vercel.json里outputDirectory写错了。
- 默认情况下，Vercel会自动探测框架（如识别
create-react-app就去找build目录），但如果你用vite build，输出是dist，就得显式告诉它：{"outputDirectory": "dist"} - 不要把
public里的文件硬塞进src——Vercel只服务outputDirectory下的内容，public/favicon.ico必须出现在构建产物里（比如Vite默认会拷过去，CRA也是），否则404 - 使用
vercel --prod前，先本地跑vercel dev，看控制台打印的Local URL是否能正常访问静态资源，比盲部署更省时间
最麻烦的其实是缓存：改了vercel.json但没生效，可能是上次部署的缓存还在，vercel --prod --force强制覆盖一次就能确认是不是配置问题。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
