添加netlify.toml后Netlify生产分支构建失败：vuepress命令未找到

这问题的根源其实是Netlify的环境变量配置逻辑在搞鬼——你手动设置的NODE_ENV覆盖了默认行为，打乱了依赖安装的节奏。

问题拆解 #

Netlify在生产构建时会自动把NODE_ENV设为production，此时默认只会安装package.json里dependencies下的包。而vuepress一般是放在devDependencies里的对吧？当你在netlify.toml里手动指定NODE_ENV = "production"时，看似是重复设置，实则触发了Netlify严格的生产依赖安装策略——直接跳过了devDependencies的安装，自然就找不到vuepress命令了。

至于非生产分支能正常构建，是因为它们不受context.production配置的影响，Netlify会默认安装所有依赖（包括devDependencies），所以vuepress能被正常调用。

解决方案 #

方案1：移除手动设置的NODE_ENV（最推荐）

Netlify在生产环境下会自动帮你设置NODE_ENV=production，完全不需要你手动在配置里写这一行。如果只是要加其他自定义环境变量，直接追加就行：

[context.production]
environment = { 
  # 在这里添加你的自定义变量，比如：
  API_BASE_URL = "https://your-prod-api.com"
}

这样Netlify会保留默认的依赖安装逻辑，devDependencies里的vuepress也会被正常安装。

方案2：强制安装所有依赖（如果必须手动设置NODE_ENV）

要是你确实有特殊需求必须手动指定NODE_ENV，那就要修改构建命令，强制让yarn安装所有依赖：

[context.production]
environment = { NODE_ENV = "production" }
build = { command = "yarn install --production=false && yarn docs:build" }

--production=false参数会让yarn无视NODE_ENV的设置，安装dependencies和devDependencies里的所有包，这样vuepress就能被找到并执行构建了。

验证 #

修改完netlify.toml后，重新触发main分支的构建，应该就能顺利找到vuepress并完成构建流程了。

内容的提问来源于stack exchange，提问作者Jelle den Burger