差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

后一修订版
前一修订版
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 命令 | 本地执行 ''vercel'' / ''vercel --prod'' | 装 Node.js,最可控,推荐 |+| CLI 命令 | 在本地命令行部署,可脚本化 | 装 Node.js(推荐) |
  
-**关键认识**:不用 Git 完全不影响功能。三种方式产出的结果一模一样,都是 ''https://项目名.vercel.app'',区别只是"代码怎么送到 Vercel"以及"以后怎么更新"。+**关键认识**:不用 Git 完全不影响功能。三种方式产出的结果一模一样,都会得到一个 ''项目名.vercel.app'' 的网址,区别只在于"代码怎么送到 Vercel"和"以后怎么更新"。
  
 ===== 二、准备工作 ===== ===== 二、准备工作 =====
  
-1. 注册账号:[[https://vercel.com/signup|vercel.com/signup]]。**用邮箱注册即可**,不必绑 Git;当然也可以用 GitHub / Google 账号登录(那只是身份认证,不代表要用它托管代码)。 +1. 注册账号:[[https://vercel.com/signup|vercel.com/signup]]。**用邮箱注册即可**,不必绑 Git;当然也能用 GitHub / Google 账号登录(那只是身份认证,不代表要用它托管代码)。 
-2. 整理本地目录,让**网站根目录**清晰——纯静态站点长这样:+2. 整理本地目录,让**网站根目录**清晰。纯静态站点长这样:
  
-<code>+```text
 my-site/ my-site/
 ├── index.html        ← 入口,必须在最外层 ├── index.html        ← 入口,必须在最外层
行 26: 行 26:
 └── images/ └── images/
     └── logo.png     └── logo.png
-</code>+```
  
-需要构建的项目(Vite / React / Next 等)则保证 ''package.json'' 在项目根目录。+需要构建的项目(Vite / React / Next 等),保证 ''package.json'' 在项目根目录即可。
  
 ===== 三、方案一:CLI 上传(推荐)===== ===== 三、方案一:CLI 上传(推荐)=====
行 34: 行 34:
 ==== 1. 安装 Node.js 与 CLI ==== ==== 1. 安装 Node.js 与 CLI ====
  
-<code bash>+```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
-</code>+```
  
 Windows 下若提示权限不足,用管理员身份打开 PowerShell 重试。 Windows 下若提示权限不足,用管理员身份打开 PowerShell 重试。
行 44: 行 44:
 ==== 2. 登录 ==== ==== 2. 登录 ====
  
-<code bash>+```bash
 vercel login vercel login
-</code>+```
  
-会让你选择登录方式(邮箱 / GitHub / Google)。选邮箱时,命令行给出一个确认地址,浏览器打开点确认即可(设备授权流程),全程不涉及 Git。+会让你选择登录方式(邮箱 / GitHub / Google)。选邮箱时,命令行给出一个确认地址,用浏览器打开点确认即可(设备授权流程),全程不涉及 Git。
  
 ==== 3. 在项目目录里部署 ==== ==== 3. 在项目目录里部署 ====
  
-<code bash>+```bash
 cd my-site cd my-site
 +
 vercel            # 部署到 Preview(预览环境),先验证效果 vercel            # 部署到 Preview(预览环境),先验证效果
 vercel --prod     # 部署到 Production(正式网址) vercel --prod     # 部署到 Production(正式网址)
-</code>+vercel --yes      # 想跳过全部交互、一律用默认值时可加这个参数 
 +```
  
-首次运行会问几个问题,答完写入 ''.vercel/'' 目录,以后就不再问:+首次运行会问几个问题,答完写入 ''.vercel/'' 目录,以后就不会重复问:
  
-<code>+```text
 ? Set up and deploy "~/my-site"?                 Y ? Set up and deploy "~/my-site"?                 Y
 ? 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?           N ? Want to modify these build settings?           N
-</code>+```
  
-想跳过全部交互、一律用默认值:''vercel --yes''。+**需要构建的项目**:Vercel 会自动识别 Vite / Next / Nuxt 等框架,用默认构建命令和默认输出目录在**云端构建**,所以你不需要先在本地构建。识别错了就在上面那步选 Y 手动填 Build Command 与 Output Directory,或者事后到控制台 Settings → Build & Development Settings 修改。
  
-**需要构建的项目**:Vercel 会自动识别 Vite / Next / Nuxt 等框架,用默认构建命令(''npm run build'')和默认输出目录在**云端构建**,所以你不需要先在本地构建。识别错了就在上面那步选 Y 手动填 Build Command 与 Output Directory,或事后到控制台 Settings → Build & Development Settings 修改。 +**纯静态项目**(没有 package.json、只有 index.html):Vercel 直接当静态站点托管,不跑任何构建。
- +
-**纯静态项目**(没有 package.json,只有 index.html):Vercel 直接当静态站点托管,不跑任何构建。+
  
 ==== 4. 更新网站 ==== ==== 4. 更新网站 ====
  
-改完代码再跑一次 ''vercel --prod'' 就行。每次部署都是**不可变快照**,旧版本不会丢。+改完代码,再执行一次生产部署那条命令就行。每次部署都是一份**不可变快照**,旧版本不会丢。
  
 ==== 5. 不想把源码传到云端 ==== ==== 5. 不想把源码传到云端 ====
  
-上面默认会上传源码、由 Vercel 云端构建。如果只想传成品:+默认行为是上传源码、由 Vercel 云端构建。只想传成品的话:
  
-<code bash>+```bash
 vercel pull --yes --environment=production   # 拉取项目配置与环境变量 vercel pull --yes --environment=production   # 拉取项目配置与环境变量
 vercel build --prod                          # 本地构建,产物在 .vercel/output vercel build --prod                          # 本地构建,产物在 .vercel/output
 vercel deploy --prebuilt --prod              # 只上传构建产物 vercel deploy --prebuilt --prod              # 只上传构建产物
-</code>+```
  
-这样 Vercel 拿到的是 ''dist'' 之类的结果,拿不到源码。+这样 Vercel 拿到的是结果文件,拿不到源码。
  
 ===== 四、方案二:网页上传(零安装)===== ===== 四、方案二:网页上传(零安装)=====
行 95: 行 95:
 不想装 Node.js 的话,控制台本身就带上传部署入口: 不想装 Node.js 的话,控制台本身就带上传部署入口:
  
-1. 打开 [[https://vercel.com/new|vercel.com/new]],或在已有项目的 **Deployments** 页面找右上角的部署按钮(不同时期文案可能是 ''Create Deployment'' 或 ''Deploy'',认准带虚线上传框的弹窗;UI 会变,以实际界面为准)。 +1. 打开 [[https://vercel.com/new|vercel.com/new]],或者在已有项目的 **Deployments** 页面找右上角的部署按钮(不同时期文案可能是 ''Create Deployment'' 或 ''Deploy'',认准带虚线上传框的弹窗;UI 会变,以实际界面为准)。 
-2. 把 ''index.html'' 所在的**整个文件夹**拖进去,或选择一个提前打好的 zip 包;还没有项目时会引导你先建一个。+2. 把 ''index.html'' 所在的**整个文件夹**拖进去,或者选择一个提前打好的 zip 包;还没有项目时会引导你先建一个。
 3. 等它跑完,页面给出 ''项目名.vercel.app'' 网址。 3. 等它跑完,页面给出 ''项目名.vercel.app'' 网址。
  
 三点提醒: 三点提醒:
  
-* 拖的是"网站根目录本身",不要把外层文件夹一起打包,否则会多出一层路径。 +  * 拖的是"网站根目录本身",不要把外层文件夹一起打包,否则会多出一层路径。 
-* 项目需要构建时,先在本地构建好、拖**产物目录**最稳妥;想省心就直接用 CLI 让云端构建。 +  * 项目需要构建时,先在本地构建好、拖**产物目录**最稳妥;想省心就直接用 CLI 让云端构建。 
-* 上传有体积上限,大项目会被拒绝,这时必须改用 CLI。+  * 上传有体积上限,大项目会被拒绝,这时必须改用 CLI。
  
 ===== 五、绑定自己的域名 ===== ===== 五、绑定自己的域名 =====
  
 1. 控制台进入项目 → Settings → Domains → Add,填域名(建议 ''example.com'' 和 ''www.example.com'' 都加上)。 1. 控制台进入项目 → Settings → Domains → Add,填域名(建议 ''example.com'' 和 ''www.example.com'' 都加上)。
-2. 按面板提示到域名服务商添加解析,**以面板显示的值优先**,常见组合是: +2. 按面板提示到域名服务商添加解析,**以面板显示的值优先**;常见组合是: 
-   * 裸域 ''example.com'':A 记录 → ''76.76.21.21'' +  * 裸域 ''example.com'':A 记录 → ''76.76.21.21'' 
-   * ''www'':CNAME → ''cname.vercel-dns.com''+  * ''www'':CNAME → ''cname.vercel-dns.com''
 3. 也可以把域名的 NS 直接托管给 Vercel,由它统一管解析。 3. 也可以把域名的 NS 直接托管给 Vercel,由它统一管解析。
 4. HTTPS 证书自动签发、自动续期,不用自己配。 4. HTTPS 证书自动签发、自动续期,不用自己配。
行 118: 行 118:
 ===== 六、更新与回滚 ===== ===== 六、更新与回滚 =====
  
-* 更新:重跑 CLI,或重新拖拽上传,产生一个新部署。 +  * 更新:重跑 CLI,或重新拖拽上传,产生一个新部署。 
-* 回滚:控制台 → Deployments → 找到旧部署 → 右侧 ⋯ → **Promote to Production**,秒级切回,无需重新构建。+  * 回滚:控制台 → Deployments → 找到旧部署 → 右侧点更多菜单 → **Promote to Production**,秒级切回,不用重新构建。
  
 常用命令: 常用命令:
  
-<code bash>+```bash
 vercel ls                # 列出本项目的历史部署 vercel ls                # 列出本项目的历史部署
 vercel inspect <url>     # 查看某次部署详情(产物、函数、耗时) vercel inspect <url>     # 查看某次部署详情(产物、函数、耗时)
行 131: 行 131:
 vercel dev               # 本地起一个接近线上的开发环境 vercel dev               # 本地起一个接近线上的开发环境
 vercel domains ls        # 查看已绑定域名 vercel domains ls        # 查看已绑定域名
-</code>+```
  
 ===== 七、vercel.json:静态站点最常用的配置 ===== ===== 七、vercel.json:静态站点最常用的配置 =====
行 157: 行 157:
 ``` ```
  
-* ''cleanUrls'':访问 ''/about'' 也能命中 ''about.html''。 +  * ''cleanUrls'':访问 ''/about'' 也能命中 ''about.html''。 
-* ''rewrites'':单页应用(SPA)刷新不 404 的经典做法——找不到的路径统一回退到 ''index.html''。静态文件优先于 rewrites 生效,所以 CSS / JS 不会被误改写。 +  * ''rewrites'':单页应用(SPA)刷新不 404 的经典做法——找不到的路径统一回退到 ''index.html''。静态文件优先于 rewrites 生效,所以 CSS / JS 不会被误改写。 
-* ''headers'':统一注入安全头,省得每页单独写,可参考 [[安全头]]。+  * ''headers'':统一注入安全头,省得每页单独写,可参考 [[安全头]]。
  
 注意:Git 集成部署时 ''vercel.json'' 必须提交进仓库才生效;CLI 上传时它待在本地目录里就够了。 注意:Git 集成部署时 ''vercel.json'' 必须提交进仓库才生效;CLI 上传时它待在本地目录里就够了。
行 167: 行 167:
 语法跟 ''.gitignore'' 一样,用来排除不上传的文件,能明显加快上传: 语法跟 ''.gitignore'' 一样,用来排除不上传的文件,能明显加快上传:
  
-<code>+```text
 node_modules node_modules
 .env .env
 *.log *.log
 /draft /draft
-</code>+```
  
 依赖目录一般会被自动忽略,显式写一份更保险。环境变量务必用 ''vercel env add'' 管理,不要写进源码。 依赖目录一般会被自动忽略,显式写一份更保险。环境变量务必用 ''vercel env add'' 管理,不要写进源码。
行 178: 行 178:
 ===== 九、常见坑 ===== ===== 九、常见坑 =====
  
-1. **根目录没有 ''index.html''** → 访问根路径直接 404。上传的必须是"网站根目录",不是它的上一级。 +  - **根目录没有 ''index.html''**:访问根路径直接 404。上传的必须是"网站根目录",不是它的上一级。 
-2. **文件名大小写**:Windows / macOS 默认不区分大小写,Vercel 的 Linux 构建环境区分。''Logo.PNG'' 引用成 ''logo.png'',本地正常、线上 404。 +  - **文件名大小写**:Windows / macOS 默认不区分大小写,Vercel 的 Linux 构建环境区分。''Logo.PNG'' 引用成 ''logo.png'',本地正常、线上 404。 
-3. **绝对路径**:部署在域名根下,写 ''/style.css'' 没问题;若要挂到子路径,改用相对路径或设置 base。 +  - **绝对路径**:部署在域名根下,写 ''/style.css'' 没问题;若要挂到子路径,改用相对路径或设置 base。 
-4. **SPA 刷新 404**:见上一节的 ''rewrites''。 +  - **SPA 刷新 404**:见第七节的 ''rewrites''。 
-5. **免费(Hobby)计划限个人非商业用途**,商业项目按条款需升级 Pro;且 Hobby 的函数区域固定、无法自选,国内访问延迟偏高。 +  - **免费(Hobby)计划限个人非商业用途**,商业项目按条款需升级 Pro;且 Hobby 的函数区域固定、无法自选,国内访问延迟偏高。 
-6. **国内网络体验**:Vercel 默认域名在国内不稳定,纯展示站可以接受;面向国内用户的服务建议同时准备国内节点或 CDN 方案。 +  - **国内网络体验**:Vercel 默认域名在国内不稳定,纯展示站可以接受;面向国内用户的服务建议同时准备国内节点或 CDN 方案。 
-7. **拖拽上传有体积上限**,大项目走 CLI。 +  - **拖拽上传有体积上限**,大项目走 CLI。 
-8. 预览环境(''vercel'')和正式环境(''vercel --prod'')是两套地址,别把预览地址当正式站发出去。+  - **预览和正式是两套地址**:只跑 ''vercel'' 得到的是预览地址,别把它当正式站发出去。
  
 ===== 十、最小可用流程回顾 ===== ===== 十、最小可用流程回顾 =====
  
 +```text
 1. 邮箱注册 Vercel 账号(不需要 Git) 1. 邮箱注册 Vercel 账号(不需要 Git)
-2. 本地准备好文件夹,根目录放 ''index.html'' +2. 本地准备好文件夹,根目录放 index.html 
-3. ''npm i -g vercel'' → ''vercel login'' +3. npm i -g vercel   →   vercel login 
-4. 在项目目录里执行 ''vercel --prod'' +4. 在项目目录里执行:  vercel --prod 
-5. 拿到 ''xxx.vercel.app'',浏览器验证页面 +5. 拿到 xxx.vercel.app,用浏览器验证页面 
-6. 需要独立域名:Settings → Domains 绑定 +6. 需要独立域名:项目 → Settings → Domains 
-7. 以后要更新:再跑一次 ''vercel --prod''+7. 以后要更新:再执行一次 vercel --prod 
 +``` 
 + 
 +===== 十一、Vercel 函数(Functions)是什么 ===== 
 + 
 +前面十节讲的都是**静态托管**:把 HTML / CSS / JS 直接发给浏览器,服务端不执行任何逻辑。 
 +但只要出现下面这些需求,就必须有代码在服务器上跑: 
 + 
 +  * 表单提交后要写数据库、发邮件 
 +  * 接收第三方平台的 Webhook 回调 
 +  * 调用需要密钥的第三方 API(例如大模型接口),而密钥不能出现在前端 JS 里 
 + 
 +**函数(Functions)就是干这个的:跑在 Vercel 云上的后端代码。** 你不用买服务器、不用配 Nginx,写一个文件传上去就是一个接口。 
 + 
 +==== 1. 三个关键概念 ==== 
 + 
 +  * **位置即路由**:函数文件放在项目根的 ''api/'' 目录,**一个文件 = 一个接口**。''api/hello.js'' 对应的地址就是 ''项目名.vercel.app/api/hello''。 
 +  * **按请求唤起**:平时没有常驻进程,只有请求打到这个地址时才被唤起,跑完就休眠。所以计费方式是**调用次数 + 执行时长**,免费额度用不完就不花钱。这就是 **Serverless(无服务器)**的含义——不是真的没有服务器,而是**你不用管服务器**。 
 +  * **和静态页面不冲突**:同一个项目里,''index.html''、CSS、图片照样走 CDN 静态分发,只有 ''/api/*'' 的请求才会去执行函数。 
 + 
 +==== 2. 写法(Node.js 运行时)==== 
 + 
 +```js 
 +// api/hello.js 
 +export default function handler(request, response) { 
 +  response.status(200).json({ ok: true, time: Date.now() }); 
 +} 
 +``` 
 + 
 +部署后浏览器直接打开 ''/api/hello'',就能看到返回的 JSON。 
 +(若项目是 CommonJS,也可以用 ''module.exports = (req, res) => {...}'' 的写法。) 
 + 
 +==== 3. 两种运行时怎么选 ==== 
 + 
 +^ 运行时 ^ 特点 ^ 适合的场景 ^ 
 +| Node.js Functions | 默认,能用完整的 Node 生态和 npm 包 | 读写数据库、发邮件、复杂业务逻辑 | 
 +| Edge Functions | 跑在全球边缘节点,基于 Web 标准 ''Request'' / ''Response'',冷启动更快 | 鉴权、重定向、A/B 测试等轻量逻辑 | 
 + 
 +Edge 只提供有限的 Web API,用不了大部分 Node 模块,别把依赖 Node 原生模块的代码往 Edge 上搬。 
 + 
 +==== 4. 容易被忽略的点 ==== 
 + 
 +  * **Next.js 里的服务端渲染、Route Handlers 本质上也是 Functions**,只是由框架自动生成,不需要你手写 ''api/'' 目录。 
 +  * **冷启动**:闲置一段时间后第一次访问会稍慢(Edge 明显更快)。 
 +  * **执行时长有上限**,长任务不适合放在函数里;具体上限随计划不同,以官方文档为准。 
 +  * **函数不保存状态**:每次调用都可能是全新实例,会话 / 计数要放数据库或 KV。 
 +  * **免费 Hobby 计划的函数区域固定**,国内访问延迟偏高。 
 +  * 本地调试:''vercel dev'' 会在本机起一个接近线上的环境。 
 + 
 +===== 十二、账单、发票与报销 ===== 
 + 
 +结论先行:**能不能报销,取决于两件事——你是不是付费用户,以及你公司财务认不认英文 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://vercel.com|Vercel 官网]]、[[https://vercel.com/docs|官方文档]]、[[https://vercel.com/docs/cli|CLI 文档]]+参考资料:[[https://vercel.com|Vercel 官网]]、[[https://vercel.com/docs|官方文档]]、[[https://vercel.com/docs/cli|CLI 文档]]、[[https://vercel.com/docs/functions|Functions 文档]]、[[https://vercel.com/docs/pricing|价格与账单文档]]
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • vercel.1791631434.txt.gz
  • 最后更改: 2026/10/10 19:23
  • 由 张叶安