环境要求

使用 gvt 前请确保本地已安装以下依赖。

必需

依赖	版本	说明
Go	1.25+	运行 gvt 与生成 Go 后端
Node.js	20+	前端脚手架依赖
npm	10+	包管理基础

推荐

依赖	版本	说明
pnpm	9+	前端默认包管理器
Docker	可选	使用 gvt docker 时必需

验证安装

go version      # go version go1.25 or higher
node -v         # v20.x or higher
npm -v          # 10.x or higher
pnpm -v         # 9.x or higher（可选）
docker -v       # 使用 Docker 时

注意事项

• 前端脚手架在运行时调用 npx create-vite@latest，需要联网访问 npm 源。
• 若网络受限，可在 init 前配置 npm 镜像源：

npm config set registry https://registry.npmmirror.com

• gvt hook 的 lint 检查会自动检测 oxlint / eslint / biome，无需提前安装特定工具链。