VSCode配置Vercel部署插件_一键将前端项目发布至生产环境-VSCode-PHP中文网

VSCode点击Deploy不能直接上线，必须先安装Vercel CLI、配置PATH、登录账号、确认项目根目录；插件仅调用底层命令，vercel命令需在终端可用且VSCode须从系统终端启动以加载正确PATH。

vscode配置vercel部署插件_一键将前端项目发布至生产环境

VSCode 里点一下 Deploy 就能上线？不行。必须先装 CLI、配好 PATH、登录账号、确认项目根目录，四步缺一不可——插件只是按钮，背后全是命令行在干活。

vercel 命令在终端能跑，但在 VSCode 里报 command not found

这不是插件坏了，是 VSCode 启动时没加载你系统的 $PATH。尤其 macOS/Linux 用户从 Dock 点开 VSCode，它根本看不到 npm 全局 bin 路径。

关掉所有 VSCode 窗口
打开系统终端（macOS Terminal / Linux GNOME Terminal / Windows PowerShell），执行 vercel --version 确认 CLI 已安装且可用
再在这个终端里输入 code . 启动 VSCode（不是双击图标）
Windows 用户若用 Git Bash，vercel 很可能不识别，换 PowerShell 或 CMD 执行 vercel login 和 code .

VSCode 插件显示 Not logged in 或 Deploy 按钮灰掉

插件不处理登录流程，也不自动探测项目结构。它只读取当前工作区根目录下的 vercel.json 或 package.json，并调用本地 vercel 命令。

确保 VSCode 当前打开的是**项目根目录**，即包含 package.json 或 vercel.json 的文件夹，不是子目录如 src/ 或 client/
在终端运行 vercel login 完成认证，插件不会弹窗让你输邮箱或 GitHub 授权
首次部署时插件会问你选 Team 还是个人账号，选错会导致后续 vercel --prod 失败；真选错了就删掉项目根目录下的 .vercel/project.json 重来

部署后页面空白或 CSS/JS 404

Vercel 默认按框架猜输出目录：create-react-app 找 build/，Next.js 找 .next/，但 Vite 默认输出 dist/ —— 它不会主动猜，得你明说。

HISUI 前端框架开发指南（IRIS版）

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。

下载

在项目根目录加 vercel.json，写清楚输出路径：
```
{"outputDirectory": "dist"}
```
别写 builds 字段，它已废弃；现在用 functions 或 overrides 替代
如果用了自定义构建命令（比如 npm run build:h5），在插件配置界面或 vercel.json 里显式设 "buildCommand": "npm run build:h5"
检查浏览器开发者工具 Network 面板，看请求的 JS/CSS 路径是否带了多余前缀（如 /myapp/static/），那可能是前端路由或 public 目录结构和 Vercel 预期不一致

vercel.json 配置不生效或被忽略

字段名大小写敏感、位置严格、版本固定——写错一个字母或放错一层，Vercel 就当它不存在。

文件名必须是 vercel.json，不能叫 vercel.config.json 或 vercel.yml
必须放在项目**根目录**，子目录里的无效
第一层必须有 "version": 2，没有这行，整个文件会被跳过
rewrites 要写全路径：
```
{"source": "/api/(.*)", "destination": "/api/index.js"}
```
，写成 from/to 或漏掉 source 都不触发
headers 不支持通配符路径，必须写具体路径或正则，例如 "/static/*" 可以，"/*.css" 不行