差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| vercel [2026/10/10 19:23] – 新建 Vercel 使用教程:不使用 Git,用 CLI / 网页上传直接部署本地代码建站 张叶安 | vercel [2026/10/12 12:41] (当前版本) – 去掉行内代码里会破坏解析的 // (本站不支持 %% nowiki),改为站点根路径写法 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| ====== Vercel 使用教程 ====== | ====== Vercel 使用教程 ====== | ||
| - | Vercel 是一个前端 / 静态站点托管平台:把本地的一堆文件(或一个前端项目)传上去,它替你跑构建、发到全球 CDN,最后给你一个可访问的 https 网址。 | + | Vercel 是一个前端 / 静态站点托管平台:把本地的一堆文件(或一个前端项目)传上去,它替你跑构建、发到全球 CDN,最后给你一个能直接访问的 https 网址。 |
| [[Next.js笔记]] 里提到过它,这篇专门讲**怎么用**,重点放在**不接 Git 仓库**的做法——直接把自己电脑上的代码传上去建站。 | [[Next.js笔记]] 里提到过它,这篇专门讲**怎么用**,重点放在**不接 Git 仓库**的做法——直接把自己电脑上的代码传上去建站。 | ||
| 行 10: | 行 10: | ||
| | Git 集成 | 绑定 GitHub / GitLab / Bitbucket,push 后自动部署 | 需要仓库,需要 Git | | | Git 集成 | 绑定 GitHub / GitLab / Bitbucket,push 后自动部署 | 需要仓库,需要 Git | | ||
| | 网页上传 | 在控制台里拖入文件夹或 zip | 什么都不用装 | | | 网页上传 | 在控制台里拖入文件夹或 zip | 什么都不用装 | | ||
| - | | CLI 命令 | 本地执行 '' | + | | CLI 命令 | 在本地命令行部署,可脚本化 |
| - | **关键认识**:不用 Git 完全不影响功能。三种方式产出的结果一模一样,都是 '' | + | **关键认识**:不用 Git 完全不影响功能。三种方式产出的结果一模一样,都会得到一个 |
| ===== 二、准备工作 ===== | ===== 二、准备工作 ===== | ||
| - | 1. 注册账号:[[https:// | + | 1. 注册账号:[[https:// |
| - | 2. 整理本地目录,让**网站根目录**清晰——纯静态站点长这样: | + | 2. 整理本地目录,让**网站根目录**清晰。纯静态站点长这样: |
| - | < | + | ```text |
| my-site/ | my-site/ | ||
| ├── index.html | ├── index.html | ||
| 行 26: | 行 26: | ||
| └── images/ | └── images/ | ||
| └── logo.png | └── logo.png | ||
| - | </ | + | ``` |
| - | 需要构建的项目(Vite / React / Next 等)则保证 '' | + | 需要构建的项目(Vite / React / Next 等),保证 '' |
| ===== 三、方案一:CLI 上传(推荐)===== | ===== 三、方案一:CLI 上传(推荐)===== | ||
| 行 34: | 行 34: | ||
| ==== 1. 安装 Node.js 与 CLI ==== | ==== 1. 安装 Node.js 与 CLI ==== | ||
| - | < | + | ```bash |
| node -v # 确认 Node 18+(新版本 CLI 要求更高,建议 20+) | node -v # 确认 Node 18+(新版本 CLI 要求更高,建议 20+) | ||
| npm i -g vercel | npm i -g vercel | ||
| vercel --version | vercel --version | ||
| - | </ | + | ``` |
| Windows 下若提示权限不足,用管理员身份打开 PowerShell 重试。 | Windows 下若提示权限不足,用管理员身份打开 PowerShell 重试。 | ||
| 行 44: | 行 44: | ||
| ==== 2. 登录 ==== | ==== 2. 登录 ==== | ||
| - | < | + | ```bash |
| vercel login | vercel login | ||
| - | </ | + | ``` |
| - | 会让你选择登录方式(邮箱 / GitHub / Google)。选邮箱时,命令行给出一个确认地址,浏览器打开点确认即可(设备授权流程),全程不涉及 Git。 | + | 会让你选择登录方式(邮箱 / GitHub / Google)。选邮箱时,命令行给出一个确认地址,用浏览器打开点确认即可(设备授权流程),全程不涉及 Git。 |
| ==== 3. 在项目目录里部署 ==== | ==== 3. 在项目目录里部署 ==== | ||
| - | < | + | ```bash |
| cd my-site | cd my-site | ||
| + | |||
| vercel | vercel | ||
| vercel --prod | vercel --prod | ||
| - | </ | + | vercel --yes # 想跳过全部交互、一律用默认值时可加这个参数 |
| + | ``` | ||
| - | 首次运行会问几个问题,答完写入 '' | + | 首次运行会问几个问题,答完写入 '' |
| - | < | + | ```text |
| ? Set up and deploy " | ? Set up and deploy " | ||
| ? Which scope do you want to deploy to? 选自己的账号 | ? Which scope do you want to deploy to? 选自己的账号 | ||
| 行 67: | 行 69: | ||
| ? In which directory is your code located? | ? In which directory is your code located? | ||
| ? Want to modify these build settings? | ? Want to modify these build settings? | ||
| - | </ | + | ``` |
| - | 想跳过全部交互、一律用默认值:'' | + | **需要构建的项目**:Vercel 会自动识别 Vite / Next / Nuxt 等框架,用默认构建命令和默认输出目录在**云端构建**,所以你不需要先在本地构建。识别错了就在上面那步选 Y 手动填 Build Command 与 Output Directory,或者事后到控制台 Settings → Build & Development Settings 修改。 |
| - | **需要构建的项目**:Vercel 会自动识别 Vite / Next / Nuxt 等框架,用默认构建命令('' | + | **纯静态项目**(没有 package.json、只有 index.html):Vercel 直接当静态站点托管,不跑任何构建。 |
| - | + | ||
| - | **纯静态项目**(没有 package.json,只有 index.html):Vercel 直接当静态站点托管,不跑任何构建。 | + | |
| ==== 4. 更新网站 ==== | ==== 4. 更新网站 ==== | ||
| - | 改完代码再跑一次 | + | 改完代码,再执行一次生产部署那条命令就行。每次部署都是一份**不可变快照**,旧版本不会丢。 |
| ==== 5. 不想把源码传到云端 ==== | ==== 5. 不想把源码传到云端 ==== | ||
| - | 上面默认会上传源码、由 Vercel 云端构建。如果只想传成品: | + | 默认行为是上传源码、由 Vercel 云端构建。只想传成品的话: |
| - | < | + | ```bash |
| vercel pull --yes --environment=production | vercel pull --yes --environment=production | ||
| vercel build --prod | vercel build --prod | ||
| vercel deploy --prebuilt --prod | vercel deploy --prebuilt --prod | ||
| - | </ | + | ``` |
| - | 这样 Vercel 拿到的是 | + | 这样 Vercel 拿到的是结果文件,拿不到源码。 |
| ===== 四、方案二:网页上传(零安装)===== | ===== 四、方案二:网页上传(零安装)===== | ||
| 行 95: | 行 95: | ||
| 不想装 Node.js 的话,控制台本身就带上传部署入口: | 不想装 Node.js 的话,控制台本身就带上传部署入口: | ||
| - | 1. 打开 [[https:// | + | 1. 打开 [[https:// |
| - | 2. 把 '' | + | 2. 把 '' |
| 3. 等它跑完,页面给出 '' | 3. 等它跑完,页面给出 '' | ||
| 三点提醒: | 三点提醒: | ||
| - | * 拖的是" | + | |
| - | * 项目需要构建时,先在本地构建好、拖**产物目录**最稳妥;想省心就直接用 CLI 让云端构建。 | + | * 项目需要构建时,先在本地构建好、拖**产物目录**最稳妥;想省心就直接用 CLI 让云端构建。 |
| - | * 上传有体积上限,大项目会被拒绝,这时必须改用 CLI。 | + | * 上传有体积上限,大项目会被拒绝,这时必须改用 CLI。 |
| ===== 五、绑定自己的域名 ===== | ===== 五、绑定自己的域名 ===== | ||
| 1. 控制台进入项目 → Settings → Domains → Add,填域名(建议 '' | 1. 控制台进入项目 → Settings → Domains → Add,填域名(建议 '' | ||
| - | 2. 按面板提示到域名服务商添加解析,**以面板显示的值优先**,常见组合是: | + | 2. 按面板提示到域名服务商添加解析,**以面板显示的值优先**;常见组合是: |
| - | | + | * 裸域 '' |
| - | | + | * '' |
| 3. 也可以把域名的 NS 直接托管给 Vercel,由它统一管解析。 | 3. 也可以把域名的 NS 直接托管给 Vercel,由它统一管解析。 | ||
| 4. HTTPS 证书自动签发、自动续期,不用自己配。 | 4. HTTPS 证书自动签发、自动续期,不用自己配。 | ||
| 行 118: | 行 118: | ||
| ===== 六、更新与回滚 ===== | ===== 六、更新与回滚 ===== | ||
| - | * 更新:重跑 CLI,或重新拖拽上传,产生一个新部署。 | + | |
| - | * 回滚:控制台 → Deployments → 找到旧部署 → 右侧 | + | * 回滚:控制台 → Deployments → 找到旧部署 → 右侧点更多菜单 |
| 常用命令: | 常用命令: | ||
| - | < | + | ```bash |
| vercel ls # 列出本项目的历史部署 | vercel ls # 列出本项目的历史部署 | ||
| vercel inspect < | vercel inspect < | ||
| 行 131: | 行 131: | ||
| vercel dev # 本地起一个接近线上的开发环境 | vercel dev # 本地起一个接近线上的开发环境 | ||
| vercel domains ls # 查看已绑定域名 | vercel domains ls # 查看已绑定域名 | ||
| - | </ | + | ``` |
| ===== 七、vercel.json:静态站点最常用的配置 ===== | ===== 七、vercel.json:静态站点最常用的配置 ===== | ||
| 行 157: | 行 157: | ||
| ``` | ``` | ||
| - | * '' | + | |
| - | * '' | + | * '' |
| - | * '' | + | * '' |
| 注意:Git 集成部署时 '' | 注意:Git 集成部署时 '' | ||
| 行 167: | 行 167: | ||
| 语法跟 '' | 语法跟 '' | ||
| - | < | + | ```text |
| node_modules | node_modules | ||
| .env | .env | ||
| *.log | *.log | ||
| /draft | /draft | ||
| - | </ | + | ``` |
| 依赖目录一般会被自动忽略,显式写一份更保险。环境变量务必用 '' | 依赖目录一般会被自动忽略,显式写一份更保险。环境变量务必用 '' | ||
| 行 178: | 行 178: | ||
| ===== 九、常见坑 ===== | ===== 九、常见坑 ===== | ||
| - | 1. **根目录没有 '' | + | - **根目录没有 '' |
| - | 2. **文件名大小写**:Windows / macOS 默认不区分大小写,Vercel 的 Linux 构建环境区分。'' | + | |
| - | 3. **绝对路径**:部署在域名根下,写 ''/ | + | |
| - | 4. **SPA 刷新 404**:见上一节的 '' | + | |
| - | 5. **免费(Hobby)计划限个人非商业用途**,商业项目按条款需升级 Pro;且 Hobby 的函数区域固定、无法自选,国内访问延迟偏高。 | + | |
| - | 6. **国内网络体验**:Vercel 默认域名在国内不稳定,纯展示站可以接受;面向国内用户的服务建议同时准备国内节点或 CDN 方案。 | + | |
| - | 7. **拖拽上传有体积上限**,大项目走 CLI。 | + | |
| - | 8. 预览环境('' | + | - **预览和正式是两套地址**:只跑 |
| ===== 十、最小可用流程回顾 ===== | ===== 十、最小可用流程回顾 ===== | ||
| + | ```text | ||
| 1. 邮箱注册 Vercel 账号(不需要 Git) | 1. 邮箱注册 Vercel 账号(不需要 Git) | ||
| - | 2. 本地准备好文件夹,根目录放 | + | 2. 本地准备好文件夹,根目录放 index.html |
| - | 3. '' | + | 3. npm i -g vercel |
| - | 4. 在项目目录里执行 | + | 4. 在项目目录里执行: |
| - | 5. 拿到 | + | 5. 拿到 xxx.vercel.app,用浏览器验证页面 |
| - | 6. 需要独立域名:Settings → Domains | + | 6. 需要独立域名:项目 → Settings → Domains |
| - | 7. 以后要更新:再跑一次 | + | 7. 以后要更新:再执行一次 vercel --prod |
| + | ``` | ||
| + | |||
| + | ===== 十一、Vercel 函数(Functions)是什么 ===== | ||
| + | |||
| + | 前面十节讲的都是**静态托管**:把 HTML / CSS / JS 直接发给浏览器,服务端不执行任何逻辑。 | ||
| + | 但只要出现下面这些需求,就必须有代码在服务器上跑: | ||
| + | |||
| + | * 表单提交后要写数据库、发邮件 | ||
| + | * 接收第三方平台的 Webhook 回调 | ||
| + | * 调用需要密钥的第三方 API(例如大模型接口),而密钥不能出现在前端 JS 里 | ||
| + | |||
| + | **函数(Functions)就是干这个的:跑在 Vercel 云上的后端代码。** 你不用买服务器、不用配 Nginx,写一个文件传上去就是一个接口。 | ||
| + | |||
| + | ==== 1. 三个关键概念 ==== | ||
| + | |||
| + | * **位置即路由**:函数文件放在项目根的 | ||
| + | * **按请求唤起**:平时没有常驻进程,只有请求打到这个地址时才被唤起,跑完就休眠。所以计费方式是**调用次数 + 执行时长**,免费额度用不完就不花钱。这就是 **Serverless(无服务器)**的含义——不是真的没有服务器,而是**你不用管服务器**。 | ||
| + | * **和静态页面不冲突**:同一个项目里,'' | ||
| + | |||
| + | ==== 2. 写法(Node.js 运行时)==== | ||
| + | |||
| + | ```js | ||
| + | // api/ | ||
| + | export default function handler(request, | ||
| + | response.status(200).json({ ok: true, time: Date.now() }); | ||
| + | } | ||
| + | ``` | ||
| + | |||
| + | 部署后浏览器直接打开 ''/ | ||
| + | (若项目是 CommonJS,也可以用 '' | ||
| + | |||
| + | ==== 3. 两种运行时怎么选 ==== | ||
| + | |||
| + | ^ 运行时 ^ 特点 ^ 适合的场景 ^ | ||
| + | | Node.js Functions | 默认,能用完整的 Node 生态和 npm 包 | 读写数据库、发邮件、复杂业务逻辑 | | ||
| + | | Edge Functions | 跑在全球边缘节点,基于 Web 标准 '' | ||
| + | |||
| + | Edge 只提供有限的 Web API,用不了大部分 Node 模块,别把依赖 Node 原生模块的代码往 Edge 上搬。 | ||
| + | |||
| + | ==== 4. 容易被忽略的点 ==== | ||
| + | |||
| + | * **Next.js 里的服务端渲染、Route Handlers 本质上也是 Functions**,只是由框架自动生成,不需要你手写 '' | ||
| + | * **冷启动**:闲置一段时间后第一次访问会稍慢(Edge 明显更快)。 | ||
| + | * **执行时长有上限**,长任务不适合放在函数里;具体上限随计划不同,以官方文档为准。 | ||
| + | * **函数不保存状态**:每次调用都可能是全新实例,会话 / 计数要放数据库或 KV。 | ||
| + | * **免费 Hobby 计划的函数区域固定**,国内访问延迟偏高。 | ||
| + | * 本地调试:'' | ||
| + | |||
| + | ===== 十二、账单、发票与报销 ===== | ||
| + | |||
| + | 结论先行:**能不能报销,取决于两件事——你是不是付费用户,以及你公司财务认不认英文 Invoice。** | ||
| + | |||
| + | ==== 1. 免费用户没有发票 ==== | ||
| + | |||
| + | Hobby 计划不产生任何费用,自然**没有发票或收据**,也就无所谓报销。要开票,前提是先升级到 Pro。 | ||
| + | |||
| + | ==== 2. 付费用户在哪里拿账单 ==== | ||
| + | |||
| + | * 控制台进入**团队 → Settings → Billing**,在账单 / Invoices 历史里可以下载每期的 Invoice / Receipt(PDF)。 | ||
| + | * 付款成功后,账单一般也会发送到账号邮箱。 | ||
| + | * 同一处可以填写**公司名、账单地址、VAT / 税号**,填好之后生成的 Invoice 才会带上这些信息——**建议在订阅之前就填好**,否则已开出的账单信息不好补。 | ||
| + | |||
| + | (Vercel 的界面文案会调整,具体菜单名以你登录后看到的 Billing 页面为准。) | ||
| + | |||
| + | ==== 3. 国内报销的现实问题 ==== | ||
| + | |||
| + | 下面几条是经验判断,**务必先跟财务确认**: | ||
| + | |||
| + | * Vercel 是海外公司,出具的是**英文 Invoice / Receipt**,不是中国的增值税专用发票或普通发票,**国内多数公司的财务不认**,也无法作为企业所得税税前扣除凭证。 | ||
| + | * 常见变通:把**信用卡账单 / 银行支付流水**和英文 Invoice 一起提交,请财务按" | ||
| + | * 若有香港或海外公司主体,通常可以直接把英文 Invoice 入账。 | ||
| + | * 报销实在走不通时,替代思路是换用国内可开票的托管平台,或把域名、CDN 交给国内厂商,Vercel 只留开发预览。 | ||
| + | |||
| + | ==== 4. 一句话总结 ==== | ||
| + | |||
| + | 个人练手用 Hobby,不用关心发票;公司项目要报销,**先问财务能不能收英文 Invoice,再决定要不要升级 Pro**。 | ||
| - | 参考资料:[[https:// | + | 参考资料:[[https:// |