手动配置开发环境

一键部署功能会在 Windows 上自动完成环境配置。如果你使用 macOS / Linux，或者希望自行管理开发环境，请参考本页面根据操作系统选择对应章节。

请根据你生成的项目技术栈，选择需要安装的工具。并非所有项目都需要全部环境。

Windows

Node.js（NestJS / Express / Vue / React 项目需要）

1. 访问 Node.js 官网 下载 LTS 版本（推荐 v20+）
2. 运行安装程序，一路点击 Next
3. 验证：打开 PowerShell 运行 node --version

安装 pnpm：

npm install -g pnpm

国内用户建议配置淘宝镜像源：

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

Java（Spring Boot 项目需要）

1. 访问 Adoptium 下载 JDK 17+ 的 Windows 安装包 (.msi)
2. 运行安装程序
3. 配置环境变量：右键 此电脑 → 属性 → 高级系统设置 → 环境变量
   • 新建系统变量 JAVA_HOME，值为 JDK 安装路径
   • 编辑 Path，添加 %JAVA_HOME%\bin
4. 验证：重新打开 PowerShell 运行 java --version

安装 Maven（Spring Boot 默认构建工具）：

1. 访问 Maven 官网 下载二进制 zip
2. 解压到 C:\Program Files\Maven
3. 添加环境变量 MAVEN_HOME，在 Path 中添加 %MAVEN_HOME%\bin
4. 验证：mvn -v

配置 Maven 阿里云镜像：编辑 %USERPROFILE%\.m2\settings.xml（不存在则创建），添加：

<settings>
  <mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>
</settings>

Python（Django / FastAPI 项目需要）

1. 访问 Python 官网 下载 Python 3.11+
2. 运行安装程序，务必勾选 "Add Python to PATH"
3. 验证：重新打开 PowerShell 运行 python --version

安装 uv（极速 Python 包管理器）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

IDE 推荐

• VS Code（通用）：winget install Microsoft.VisualStudioCode
• IntelliJ IDEA Community（Java）：winget install JetBrains.IntelliJIDEA.Community
• PyCharm Community（Python）：winget install JetBrains.PyCharm.Community

macOS

前置：安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Node.js（NestJS / Express / Vue / React 项目需要）

brew install node@20
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com

验证：node -v && pnpm -v

Java（Spring Boot 项目需要）

brew install openjdk@17
brew install maven

验证：java -version && mvn -v

配置 Maven 阿里云镜像：编辑 ~/.m2/settings.xml（不存在则创建），添加：

<settings>
  <mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>
</settings>

Python（Django / FastAPI 项目需要）

brew install python@3.11
curl -LsSf https://astral.sh/uv/install.sh | sh

验证：python3 --version && uv --version

IDE 推荐

brew install --cask visual-studio-code      # 通用
brew install --cask intellij-idea-ce         # Java
brew install --cask pycharm-ce              # Python

Linux (Ubuntu/Debian)

Node.js（NestJS / Express / Vue / React 项目需要）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com

验证：node -v && pnpm -v

Java（Spring Boot 项目需要）

sudo apt update && sudo apt install -y openjdk-17-jdk maven

验证：java -version && mvn -v

配置 Maven 阿里云镜像：编辑 ~/.m2/settings.xml（不存在则创建），添加：

<settings>
  <mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>
</settings>

Python（Django / FastAPI 项目需要）

sudo apt update && sudo apt install -y python3 python3-pip python3-venv
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.cargo/env

验证：python3 --version && uv --version

IDE 推荐

sudo snap install code --classic              # 通用
sudo snap install intellij-idea-community --classic  # Java
sudo snap install pycharm-community --classic        # Python

安装完成后

环境配置完成后，可以继续：

• 手动运行项目
• 部署项目