一、教程说明
飞虎CMS使用Go语言+IRIS框架+MySQL开发,项目编辑器使用VS Code,全程在 Windows 11 环境操作,最终可无缝编译部署到 Linux 服务器。

二、前期准备(已经完成)
这几天的教程都是写的是准备工作,准备如下:
(一)、开发工具清单
1、安装了万能编辑器Visual Studio Code(VS Code),并安装了下列插件: Microsoft 官方发布的中文(简体)语言包、来自Go Team at Google 官方发布的Go插件、安装常用配置工具:Go: Install/Update Tools、Code Runner插件、Error Lens插件。
2、安装数据库管理软件Navicat Premium。
3、安装最新版Go语言安装包,安装的是最新版的Go1.26.2了。
4、安装数据库软件MySQL8.4.8。
5、命令行,我使用Windows 11 专业版自带的Windows PowerShell。
(二)、前置配置(必做)
1、VS Code 中文乱码永久修复
目前是在本地Windows电脑上面开发,但是最终的代码还是在Linux服务器上面跑的,Go 语言、Iris 框架、Linux 服务器全部只认 UTF-8 编码,因此,在写第一行代码之前,必须把代码编辑器的编码设置为UTF-8 编码。
打开 VS Code,点击设置图标,选择【设置】按钮,按快捷键是(Ctrl + ,),搜索框输入:encoding,找到 Files: Encoding,下拉选择:UTF-8。(如果默认是UTF-8就可以,如果不是UTF-8就改成UTF-8)。
2、Go 国内代理配置(解决依赖下载失败)
国内直接访问 Go 官方源会超时,需配置国内镜像:打开 PowerShell,执行以下命令:
go env -w GOPROXY=https://goproxy.cn,direct
执行后无报错即配置成功,后续所有依赖下载均通过国内源,速度快、不超时。
三、项目初始化(核心步骤)
1、创建项目目录
在 D 盘新建文件夹 feihucms,最终项目路径为 D:\feihucms,本教程所有操作均基于此目录。
2、初始化 Go 项目模块
打开 PowerShell,执行以下命令进入项目目录:
cd D:\feihucms
执行项目初始化命令:
go mod init feihucms
执行成功后,目录下会自动生成 go.mod 文件(Go 项目依赖配置文件),输出如下:
go: creating new go.mod: module feihucms
3、安装 Iris 框架(飞虎 CMS 核心框架)
在 PowerShell 中执行以下命令,安装 Iris 框架:
go get github.com/kataras/iris/v12@latest
等待下载完成(首次安装会自动下载所有依赖),执行成功后目录下会生成 go.sum 文件(依赖版本校验文件)。
四、编写项目入口文件 main.go
1、用 VS Code 打开项目
打开 VS Code,将 D:\feihucms 文件夹拖入 VS Code,完成项目打开。
2、新建入口文件
在 VS Code 中右键项目目录 → 「新建文件」,命名为 main.go,复制以下完整代码:
package main
// 导入Iris框架,用于开发飞虎CMS
import "github.com/kataras/iris/v12"
// 飞虎CMS 主程序入口
func main() {
// 创建Iris应用实例
app := iris.New()
// 飞虎CMS 首页路由
app.Get("/", func(ctx iris.Context) {
ctx.WriteString("飞虎CMS 启动成功!\n")
ctx.WriteString("开发环境:Windows 11\n")
ctx.WriteString("部署环境:Linux 服务器\n")
ctx.WriteString("项目名称:feihucms\n")
})
// 启动服务,监听8080端口
app.Listen(":8080")
}按下 Ctrl + S 保存文件,确认编码为 UTF-8,中文显示正常。
五、运行项目与验证
1、启动项目
回到 PowerShell,在 D:\feihucms 目录下执行:
go run main.go
执行成功后,输出如下内容:
Iris Version: 12.2.11
Now listening on:
> Network: http://192.168.1.80:8080
> Local: http://localhost:8080
Application started. Press CTRL+C to shut down.
2、浏览器访问验证
打开任意浏览器,输入地址 http://localhost:8080,页面显示如下内容,即代表项目启动成功:
飞虎CMS 启动成功!
开发环境:Windows 11
部署环境:Linux 服务器
项目名称:feihucms
实际上:http://192.168.1.80:8080 和http://127.0.0.1:8080 都是一样的。
3、停止项目
在 PowerShell 中按下 Ctrl + C,即可停止项目运行。
六、当前项目结构(纯净版)
D:\feihucms
├── go.mod // Go项目依赖配置文件
├── go.sum // 依赖版本校验文件
└── main.go // 飞虎CMS主入口文件
七、本文总结
本文完成了飞虎 CMS 的基础环境搭建、项目初始化、框架安装与首次运行,验证了 Windows 开发环境的可用性,为后续数据库连接、功能开发奠定了基础。下一文将讲解 MySQL 数据库创建、连接与核心数据表设计。
本文的图文教程:
https://mp.weixin.qq.com/s/ctaALPcniJEavzyL83oVlA
