DocsFlopCodeInstallation

安装

通过 npm 全局安装 FlopCode，支持 macOS、Linux 和 Windows。

系统要求

  • Node.js >= 18（推荐 20 LTS 或更高版本）
  • npm >= 8
  • 操作系统：macOS、Linux、Windows（WSL 推荐）
  • 终端：支持 ANSI 颜色的现代终端

安装

npm install -g flopcode

验证安装

flopcode --version
# 输出类似: flopcode v1.x.x

更新

FlopCode 在每次启动时会自动检查更新。如果发现新版本，会自动安装并重启。你也可以手动更新：

npm install -g flopcode@latest

跳过自动更新

如果你希望跳过启动时的自动更新检查，可以设置环境变量：
FLOPCODE_NO_UPDATE=1 flopcode

常见安装问题

权限错误

如果遇到 EACCES 权限错误，不要使用 sudo。推荐修改 npm 全局安装路径：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# 然后将 ~/.npm-global/bin 添加到 PATH

Node.js 版本过低

推荐使用 nvm 管理 Node.js 版本：

nvm install 20
nvm use 20

网络问题

如果 npm 安装速度慢，可以使用国内镜像：

npm install -g flopcode --registry https://registry.npmmirror.com