活版印字

Gridea-Pro 是基于 Wails v2（Go + Vue 3） 开发的跨平台静态博客客户端，核心依赖 Go、Node.js、Wails 工具链，结合官方文档，记录源码拉取、环境配置、开发调试、编译打包全流程步骤，适配代码调试需求。

一、前置环境准备（按顺序安装）

1. 安装 Git（拉取源码）
2. 安装 Go 语言（核心后端依赖）
   从 Go官网下载安装包，选择 Windows (x86_64) MSI 安装器。
3. 安装 Node.js（前端 Vue3 依赖）
4. 安装 Wails v2
   (1)执行 Wails 安装命令（PowerShell）：

   go install github.com/wailsapp/wails/v2/cmd/wails@latest
   

   (2)刷新环境变量（重启终端），验证安装：

   wails version
   

5. WebView2 依赖
   Windows 编译 Wails 项目需要 WebView2 运行时，系统一般预装，缺失则手动安装。

二、拉取项目源码

（略）

三、安装前端依赖

Gridea-Pro 前端代码在 frontend 目录，需要单独安装 Vue3 等依赖。在powershell中运行以下命令：

# 进入前端目录
cd frontend
# 安装所有前端依赖
npm install
# 返回项目根目录（后续命令都在根目录执行）
cd ..

四、开发模式：运行 & 实时调试

1. 启动开发调试模式

在项目根目录执行：

wails dev

执行成功后会自动编译 Go 后端代码，启动 Vue3 前端开发服务，自动弹出 Gridea-Pro 客户端窗口

2. 代码调试方法

(1)前端 Vue3 代码调试
客户端窗口打开后，按 F12 调出浏览器开发者工具；
在 Sources 面板找到前端源码，添加断点、查看日志、排查样式 / 交互问题；
修改 frontend/src 下的 Vue/JS/CSS 代码，页面会即时刷新。
(2)Go 后端代码调试
安装 VS Code，并安装官方 Go 插件。用 VS Code 打开整个 gridea-pro 项目。
在 Go 源码（根目录 .go 文件、internal 目录）左侧行号处点击添加断点。
终端保持 wails dev 运行，操作客户端功能，代码运行到断点会自动暂停。
可查看变量、调用栈、单步执行，完成后端逻辑调试。
安装 Trae & Trae Solo，用 VS Code 打开整个 gridea-pro 项目，按照弹出提示安装 Go 和 Vue 插件。使用传统调试方法的同时，亦可使用Agent交互让AI分析、修改、调试和审查代码。由于上下文处理能力，以及修改文件更新覆盖等问题，应更注重版本控制和备份。

五、编译生产版本

调试完成后，可编译生成正式 .exe 安装包 / 绿色程序，命令依旧在项目根目录执行；

wails build

编译成功后，产物默认生成在项目 build/bin 目录下；Windows 平台会生成 Gridea-Pro.exe。
精简压缩包（体积更小）

wails build -compress

编译后会额外生成压缩包，方便分发。
只打包、不生成安装程序（纯绿色 exe）

wails build -nsis=false

只保留免运行的 exe 程序，去掉 Windows 安装包。
生产模式（关闭调试、优化性能，正式发布用）

wails build -production

代码会做混淆 / 优化，去掉调试信息，适合对外发布。
兼顾体积 + 正式版本

wails build -production -compress

首次编译较慢会自动拉取依赖、编译前后端，耐心等待即可。