Files
bl/docs/development.md
2025-06-20 17:13:51 +08:00

119 lines
3.3 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 开发环境
[返回目录](README.md)
::: warning 注意
推荐使用 Linux MacOS 进行开发Windows 下可使用 WSL2
Linux WSL2 下推荐使用 root 用户进行开发.
:::
## Node.js 环境
官网下载地址[https://nodejs.org/en/download/](https://nodejs.org/en/download/)
一般选择 LTS 版本即可
MacOS 下可使用 Homebrew 进行安装 nvm
```bash
brew install nvm
```
nvm node 版本管理工具可以通过`nvm install <version>` 安装指定版本使用 `nvm use <version>` 切换版本
或者直接下载 pkg 安装包进行安装
Linux 下可使用以下脚本进行安装
```bash
wget -O nodejs-install.sh https://cool-team-official.github.io/cool-admin-go/scripts/nodejs-install.sh \
&& chmod +x nodejs-install.sh \
&& ./nodejs-install.sh 18.12.0
```
脚本文件内容如下:
<<< @/docs/.vuepress/public/scripts/nodejs-install.sh
::: tip
安装完成后可使用`node -v`查看版本号使用`npm -v`查看 npm 版本号
为提高依赖包下载速度可使用`npm config set registry https://registry.npmmirror.com`切换到淘宝镜像
新版本的 node 已经集成了 yarn,需激活`corepack`,可使用 `corepack enable`命令激活激活后可使用`yarn -v`查看版本号
Linux 安装脚本已完成镜像切换及 corepack 激活
:::
## Go 环境
官网下载地址[https://go.dev/dl/](https://go.dev/dl/)
一般选择最新版本即可
MacOS 下可使用 Homebrew 进行安装
```bash
brew install go
```
或者直接下载 pkg 安装包进行安装
Linux 下可使用以下脚本进行安装
```bash
wget -O golang-install.sh https://cool-team-official.github.io/cool-admin-go/scripts/golang-install.sh \
&& chmod +x golang-install.sh \
&& ./golang-install.sh 1.19.3
```
脚本文件内容如下:
<<< @/docs/.vuepress/public/scripts/golang-install.sh
::: tip
安装完成后可使用`go version`查看版本号
为提高依赖下载速度推荐配置`goproxy`可使用`go env -w GOPROXY=https://goproxy.cn,direct`切换到 goproxy.cn 镜像
:::
## VSCode
官网下载地址[https://code.visualstudio.com/](https://code.visualstudio.com/)
一般选择最新版本即可
推荐安装以下插件
- [Go](https://marketplace.visualstudio.com/items?itemName=golang.go)
- [Vetur](https://marketplace.visualstudio.com/items?itemName=octref.vetur)
- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)
- [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
- [EditorConfig](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)
- [GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens)
## Docker
云原生时代Docker 已经成为开发者必备的工具之一
开发过程中我们将使用 Docker 进行数据库管理以及打包测试
官网下载地址[https://www.docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop)
一般选择最新版本即可
配置 Docker 镜像加速器
```bash
# Linux
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://registry.docker-cn.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
```
MacOS Windows 下可在 Docker Desktop 的设置中配置