部署到 Netlify
约 630 字大约 2 分钟
2026-08-31
Netlify 是老牌静态托管平台，与 Vercel 定位相近：Git 推送自动构建、免费 SSL、每个 PR 自动生成预览链接。
前置条件
- 代码已托管在 GitHub / GitLab / Bitbucket / Azure DevOps
src/config/siteConfig.ts中的site已设置为正式域名
方式一：控制台导入
登录 Netlify 控制台，点击 Add a new site → Import an existing project。
选择 Git 提供商并授权，从列表中选择你的 Shirone 仓库。
确认构建设置：
配置项 值 Build command pnpm buildPublish directory dist在 Environment variables 中添加
NODE_VERSION = 22。点击 Deploy 完成首次部署。
方式二：netlify.toml 声明式配置
在仓库根目录创建 netlify.toml，将构建配置固化到代码中，避免依赖控制台设置：
[build]
command = "pnpm build"
publish = "dist"
[build.environment]
NODE_VERSION = "22"提交后重新推送，Netlify 会自动读取该文件并应用配置。
方式三：CLI 部署
pnpm add -g netlify-cli
netlify login # 按提示在浏览器中授权
netlify init # 关联 Git 仓库，自动生成 netlify.toml
netlify deploy --build --prod # 构建并部署到生产netlify init 会向仓库添加部署密钥，此后 git push 即可触发自动构建。
预览部署
导入项目后，所有对非生产分支的推送、以及每个 Pull Request，都会自动生成独立的预览站点（<branch>--<site-name>.netlify.app）。写作时可以先把草稿推到分支，在预览链接中检查排版，再合并到 main 发布。
自定义域名
- 添加域名：进入 Site settings → Domain management → Add a domain，输入你的域名。
- 配置 DNS：按提示添加 DNS 记录（Netlify DNS 托管或外部 CNAME 均可）。
- 签发 SSL：SSL 证书由 Let's Encrypt 自动签发与续期，无需手动操作。
常见问题
构建失败：pnpm 版本不符
Netlify 内置的 pnpm 版本可能与仓库锁定的 pnpm@9.14.4 不一致。通过环境变量固定版本：
[build.environment]
NODE_VERSION = "22"若仍报 pnpm 相关错误，可在构建命令中显式启用 corepack：corepack enable && pnpm build。
构建产物体积超限
Netlify 单次部署限制产物 10k 文件、站点总大小视套餐而定。Shirone 的字体子集化与缩略图机制已尽量控制体积，若仍超限，检查 public/ 中是否误放了原始大图。
国内访问速度
Netlify 在中国大陆的访问质量不稳定。若你的主要读者在国内，建议优先考虑 EdgeOne Pages。