环境配置 | LinaPro.AI - 面向可持续交付的 AI 原生全栈框架

版本：0.3.x(Latest)

环境组件

LinaPro在源码开发时会依赖以下组件，需在本机预先安装好相关组件。

组件	版本要求	说明
`Git`	-	版本控制，安装脚本依赖
`Go`	`1.25+`	后端服务运行时
`Node.js`	`20.19+`	前端构建环境
`pnpm`	`10.0+`	前端包管理器
`PostgreSQL`	`14+`	默认关系型数据库

Git

macOS 和大多数 Linux 发行版已预装Git，可通过git --version确认是否可用。如未安装：

macOS / Linux
Windows

# macOS
brew install git

# Ubuntu / Debian
sudo apt install git

# CentOS / RHEL
sudo yum install git

访问 git-scm.com 下载并安装Git for Windows。安装完成后，可以在cmd.exe、PowerShell、Git Bash或WSL中使用git命令。

Go

需要Go 1.25及以上版本，可通过go version确认当前版本。

macOS / Linux
Windows

# macOS（Homebrew）
brew install go

# Linux — 下载官方预编译包，将版本号替换为最新稳定版
# 最新版本列表：https://go.dev/dl/
# 以 Linux amd64 go1.25.10 为例：
wget https://go.dev/dl/go1.25.10.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.25.10.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc && source ~/.bashrc

访问 go.dev/dl 下载Windows安装包（.msi）完成图形化安装，或在WSL中按Linux步骤安装。

Node.js

推荐通过nvm管理Node.js版本，最低需要v20.19.0。

macOS / Linux
Windows

# 通过 nvm 安装（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/HEAD/install.sh | bash
# 重新加载 shell 后执行
nvm install --lts
nvm use --lts

# 或通过 Homebrew（仅 macOS）
brew install node

推荐使用 nvm-windows 或访问 nodejs.org 下载Windows版本。也可以在WSL中按Linux步骤安装nvm。

安装完成后运行node --version，确认输出版本不低于v20.19.0。

pnpm

pnpm是LinaPro前端工程指定的包管理器，请勿使用npm或yarn替代。

npm install -g pnpm

安装完成后运行pnpm --version，确认输出版本不低于10.0.0。

PostgreSQL

LinaPro默认使用PostgreSQL 14+作为数据库。运行make init或make dev之前，请先准备好可连接的PostgreSQL实例。

macOS / Linux
Docker
Windows

# macOS（Homebrew）
brew install postgresql@14
brew services start postgresql@14

# Ubuntu / Debian
sudo apt install postgresql
sudo systemctl enable --now postgresql

# CentOS / RHEL
sudo yum install postgresql-server postgresql-contrib
sudo postgresql-setup --initdb
sudo systemctl enable --now postgresql

如果本机已安装Docker，可以直接启动一个本地PostgreSQL容器：

docker run \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=postgres \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_DB=linapro \
  postgres:14-alpine

可通过 PostgreSQL Windows installer 在Windows侧安装，也可以使用Docker Desktop运行上面的PostgreSQL容器。使用WSL时，可从WSL通过127.0.0.1访问Windows侧数据库，或直接在WSL发行版内安装PostgreSQL。

开发技能(Agent Skills)

以下为LinaPro推荐安装的Agent Skills：

技能	是否必须	作用
`OpenSpec`	建议	可选的规范驱动工作流工具，推荐配合使用以获得最佳体验
`goframe-v2`	建议	`GoFrame`专属`AI`技能，提供代码生成、错误诊断和性能优化建议，提升`Go`框架代码生成质量
`find-skills`	建议	`AI`技能市场搜索工具，帮助开发者快速查找和评估适合项目的`AI`技能，提升技能选型效率

OpenSpec

OpenSpec是可选的规范驱动工作流命令行工具，推荐安装以获得完整的规范驱动工作流体验。安装后，/opsx:explore、/opsx:propose、/opsx:apply和/opsx:archive等工作流技能将自动使用OpenSpec作为底层引擎。

npm install -g @fission-ai/openspec@latest

goframe-v2

goframe-v2是专为GoFrame开发框架提供的Agent Skill，内置GoFrame编码规范、ORM使用模式和最佳实践示例。编写或修改后端Go代码时，该技能将自动激活。

npx skills add github.com/gogf/skills -g

find-skills

find-skills是Agent技能市场搜索工具，帮助开发者快速查找和评估适合项目的Agent Skills，提升技能选型效率。

npx skills add vercel-labs/skills --skill find-skills -g

环境组件​

Git​

Go​

Node.js​

pnpm​

PostgreSQL​

开发技能(Agent Skills)​

OpenSpec​

goframe-v2​

find-skills​