环境组件
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/
sudo tar -C /usr/local -xzf go*.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
该示例使用postgres:[email protected]:5432连接linapro数据库。如果沿用这个密码，请将项目config.yaml中的database.default.link改为pgsql:postgres:12345678@tcp(127.0.0.1:5432)/linapro?sslmode=disable。
可通过 PostgreSQL Windows installer 在Windows侧安装，也可以使用Docker Desktop运行上面的PostgreSQL容器。使用WSL时，可从WSL通过127.0.0.1访问Windows侧数据库，或直接在WSL发行版内安装PostgreSQL。
LinaPro默认使用postgres:[email protected]:5432连接linapro数据库，对应连接串为pgsql:postgres:postgres@tcp(127.0.0.1:5432)/linapro?sslmode=disable，可在项目的config.yaml中修改连接配置。
Make
macOS和Linux系统通常已内置了make工具。如未安装：
- macOS / Linux
- Windows
# macOS（同时会安装 Git 等命令行工具）
xcode-select --install
# Ubuntu / Debian
sudo apt install build-essential
# CentOS / RHEL
sudo yum groupinstall "Development Tools"
Windows不要求安装GNU Make。仓库根目录提供make.cmd薄包装入口，cmd.exe中可以直接执行make help，PowerShell中使用.\make help或.\make.cmd help。
开发技能(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是专为LinaPro后端Go代码定制的Claude Code技能，内置GoFrame编码规范、ORM使用模式和最佳实践示例。编写或修改后端Go代码时，该技能将自动激活。
npx skills add github.com/gogf/skills -g
find-skills
find-skills是AI技能市场搜索工具，帮助开发者快速查找和评估适合项目的AI技能，提升技能选型效率。
npx skills add vercel-labs/skills --skill find-skills -g