跳到主要内容

Windows 用户特别指南

本指南专门为 Windows 用户提供使用 Lovrabet CLI 的详细说明和注意事项。

📝 重要建议​

为了获得最佳体验，我们强烈推荐 Windows 用户使用 Git Bash。在不同终端中的支持情况：

  • ✅ Git Bash - 完全测试验证，功能完整，体验最佳
  • ⚠️ Windows CMD - 基础功能可用，但未经充分测试
  • ⚠️ PowerShell - 基础功能可用，可能有部分限制
  • ⚠️ Windows Terminal - 取决于具体使用的 shell 类型

环境准备​

1. 安装 Git for Windows​

这是使用 Lovrabet CLI 的必要步骤：

  1. 访问 https://git-scm.com/download/win
  2. 下载最新版本的 Git for Windows
  3. 运行安装程序，使用默认设置即可
  4. 安装完成后，你就拥有了 Git Bash

2. 安装 Node.js​

  1. 访问 https://nodejs.org/
  2. 下载最新的 LTS 版本（版本号 >= 20）
  3. 运行安装程序
  4. 重要：安装完成后重启电脑或重新打开所有终端窗口

3. 验证环境​

打开 Git Bash 并运行以下命令：

# 检查 Git Bash 环境
echo $0
# 应该输出类似 "-bash" 或包含 "bash" 的内容

# 检查 Node.js
node --version
# 应该输出 v20.x.x 或更高版本

# 检查 npm
npm --version
# 应该输出版本号

安装 Lovrabet CLI​

在 Git Bash 中运行：

npm install --global @lovrabet/cli

如果遇到权限问题，尝试以管理员身份运行 Git Bash：

  1. 右键点击 Git Bash 图标
  2. 选择"以管理员身份运行"
  3. 重新执行安装命令

完整使用示例​

以下是一个完整的 Windows 使用流程（以 Git Bash 为例，推荐使用）：

# 1. 打开 Git Bash（右键文件夹选择 Git Bash Here）

# 2. 验证环境
node --version
lovrabet --version

# 3. 登录认证
lovrabet auth
# 浏览器会自动打开，完成登录后回到终端按 q 退出

# 4. 创建项目
lovrabet create my-project
cd my-project

# 5. 配置应用
lovrabet config set app my-app-code

# 6. 生成 API
lovrabet api pull

# 7. 启动开发服务器
lovrabet start
# 浏览器会自动打开 http://localhost:5173

获取帮助​

如果遇到其他问题：

  1. 查看故障排查: 故障排查指南
  2. 尝试不同终端: 如果在 CMD/PowerShell 中遇到问题，请尝试在 Git Bash 中重复操作
  3. 收集信息: 提供详细的错误信息和系统信息给技术支持

提供信息时请包含：

  • Windows 版本：运行 winver 查看
  • Git Bash 版本：运行 git --version 查看
  • Node.js 版本：运行 node --version 查看
  • CLI 版本：运行 lovrabet --version 查看
  • 完整的错误信息截图