跳转到主要内容

开发环境准备

为了更好的开发体验,我们提供了一些工具配置、项目说明,以便于您更好的开发
完成本指南后,您将拥有一个配置完善的开发环境,可以开始对必定AI项目进行开发和调试。

前置准备

本地运行必定AI之前,你首先需要安装一些开发环境依赖项:
  • Docker
  • NodeJS
  • pnpm
提示:如果您已经安装了这些依赖项,可以跳过相应的安装步骤。

环境准备

Docker 安装

MacOS

Apple Silicon 芯片

Download for Mac – Apple Silicon
如果是Intel芯片的Mac则点击下面的链接下载

Intel 芯片

Download for Mac – Intel Chip

Windows

Windows AMD64

Download for Windows – AMD64

Windows ARM64

Download for Windows – ARM64
下载完成之后打开安装包,按照安装指引进行安装。安装完成之后,可以打开终端,输入下列命令并回车运行:
docker --version
# 安装成功则会打印如下类似版本号信息
# Docker version 2x.x.x, build xxxxxxx

NodeJS 安装

通过nvm安装和管理(推荐)

重要:使用nvm安装和管理Node.js之前,请先卸载掉所有已安装的Node.js!
MacOS
# 下载并安装 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 代替重启 shell
\. "$HOME/.nvm/nvm.sh"
# 下载并安装 Node.js:
nvm install 22
# 验证 Node.js 版本:
node -v # Should print "v22.xx.x".
# 验证 npm 版本:
npm -v # Should print "11.x.x".
Windows

nvm-windows 下载地址

下载地址
下载完成之后打开安装包,按照安装指引进行安装。安装时,切勿修改默认安装路径,否则可能会导致nvm无法正常工作。 安装完成之后,可以打开终端,输入下列命令并回车运行:
nvm --version
# 安装成功则会打印如下类似版本号信息
# 1.2.x
# 下载并安装 Node.js:
nvm install 22
# 验证 Node.js 版本:
node -v # Should print "v22.xx.x".
# 验证 npm 版本:
npm -v # Should print "11.x.x".

通过官方安装包安装(v22.21.1)

MacOS

Node.js for MacOS

Download for Mac
Windows

Node.js for Windows x64

Download for Windows – x64

Node.js for Windows x86

Download for Windows – x86

Node.js for Windows ARM64

Download for Windows – ARM64
下载完成后,打开安装包,按照安装指引进行安装。安装完成之后,可以打开终端,输入下列命令并回车运行:
node -v # Should print "v22.21.1".
npm -v # Should print "11.x.x".
更多安装方式可以通过 Node.js官网 查看

pnpm 安装

安装完 Node.js 之后,可以通过 npm 安装 pnpm:
npm install -g pnpm
验证安装:
pnpm --version
如果输出版本号,则说明安装成功。

完成配置

🎉 恭喜你,到此为止所有环境已经准备完毕!
现在您可以开始对必定AI项目进行开发了。