用途:指导使用 Netlify CLI 安装、认证、关联站点并部署站点,覆盖 Git 持续部署与手动部署两种方式。
安装与认证:全局安装 npm install -g netlify-cli,CI 中本地安装 npm install netlify-cli -D,需 Node.js 18.14.0+。netlify login 打开浏览器 OAuth,netlify status 查看认证与关联状态;CI 改用 NETLIFY_AUTH_TOKEN 环境变量,并需另设 NETLIFY_SITE_ID 指定目标站点,否则部署无目标会失败或提示。
关联站点:netlify link 交互关联,或 netlify link --git-remote-url 按 Git 远程关联;netlify init 创建站点并配置 Git CI/CD,netlify init --manual 不带 Git。站点 ID 存于 .netlify/state.json,应加入 .gitignore。
部署:Git 方式由 netlify init 配置,推送生产分支触发生产部署,PR 生成 Deploy Preview,其他分支部署默认关闭需在设置中开启;构建在 Netlify 服务器运行,netlify.toml 优先于 UI 配置,monorepo 按包目录、base 目录、仓库根顺序查找。手动方式先本地构建再 netlify deploy(草稿)或 netlify deploy --prod(生产),可用 --dir=dist 指定输出目录;手动 --prod 会被后续 Git 推送替换,可锁定已发布部署。草稿、预览、分支部署与永久链接的 URL 均可被持链接者访问,需在 UI 开启站点保护限制访问。
本地开发:netlify dev 包装框架开发服务器,注入环境变量并处理函数、重定向与请求头;Vite 项目可安装 @netlify/vite-plugin 并在 vite.config.ts 中引入,直接运行常规 dev 命令。
环境变量:netlify env:set/get/list/import/unset 管理,支持 --secret 与 --context 按上下文作用域;服务端用 Netlify.env.get 或 process.env,客户端仅暴露 VITE_ 或 PUBLIC_ 前缀变量,切勿用于密钥。命令失败时应报告错误、部署日志 URL 与受影响站点分支并停止,不要自行编造恢复命令或调用底层 API。常用命令包括 netlify status、dev、build、deploy、dev:exec、env:list、clone。