用途:通过仓库根目录(monorepo 为 base/package 目录)的三个文件配置 Netlify 构建与路由:netlify.toml(构建、上下文、插件、函数、重定向、响应头、dev)、_redirects(纯文本重定向/重写规则,放入发布目录)、_headers(纯文本响应头)。netlify.toml 与 UI 冲突时以 toml 为准,路径相对 base 目录。
主要能力:在 [build] 中设置 base、publish、command、environment,并用 [context.production]、[context.deploy-preview]、[context."feat/branch"] 做上下文覆盖;重定向支持状态码、force/shadow、splat、占位符、查询参数与 Country/Language/Cookie 条件;可配置代理、签名代理、自定义响应头、函数目录与打包器(node_bundler = "esbuild")、环境变量、忽略构建(ignore)、Netlify Dev 与插件。
必要用法:SPA 需加 /* /index.html 200 回退;环境变量可用 CLI:netlify env:set KEY value、netlify env:import .env、netlify env:list --plain --context production > .env;本地构建用 netlify build。
限制:netlify.toml 中 key = "$VAR" 不支持(签名代理除外),需用 sed 或构建插件;重定向无法增删末尾斜杠;splat 只能在段末,占位符只能在段首;响应头为全局,不作用于代理内容或函数/边缘响应;netlify.toml 环境变量不供函数/边缘运行时读取;密钥变量只写、需显式上下文与作用域;敏感变量策略不适用于 GitHub Enterprise Server / GitLab 自管理仓库。更多细节见官方文档链接。