167 lines
3.2 KiB
Markdown
167 lines
3.2 KiB
Markdown
# MeshRay Windows 无控制台窗口版本 - 快速指南
|
||
|
||
**更新时间**: 2026-03-24
|
||
**编译参数**: `-ldflags "-s -w -H=windowsgui"`
|
||
|
||
---
|
||
|
||
## 🚀 **快速编译**
|
||
|
||
### 方法一：一键编译（推荐）
|
||
|
||
在项目根目录执行：
|
||
|
||
```bash
|
||
go build -o meshray.exe -ldflags "-s -w -H=windowsgui" ./cmd/meshray
|
||
```
|
||
|
||
**效果**:
|
||
- ✅ 不显示控制台窗口
|
||
- ✅ 系统托盘图标正常
|
||
- ✅ 文件体积优化（约 31 MB）
|
||
|
||
---
|
||
|
||
### 方法二：使用批处理脚本
|
||
|
||
双击运行 `build.bat`，自动完成编译。
|
||
|
||
**注意**: 如果遇到编码问题，请使用方法一手动编译。
|
||
|
||
---
|
||
|
||
## ✅ **验证结果**
|
||
|
||
### 1. 检查文件大小
|
||
|
||
```bash
|
||
ls meshray.exe
|
||
# 应该约 31 MB
|
||
```
|
||
|
||
---
|
||
|
||
### 2. 运行测试
|
||
|
||
**双击运行** `meshray.exe`：
|
||
|
||
**预期效果**:
|
||
- ✅ 没有黑色控制台窗口弹出
|
||
- ✅ 系统托盘出现 MeshRay 图标
|
||
- ✅ 可以通过托盘菜单操作
|
||
|
||
**❌ 如果看到控制台窗口**:
|
||
- 可能忘记添加 `-H=windowsgui` 参数
|
||
- 可能运行了旧版本程序
|
||
|
||
---
|
||
|
||
## 🔧 **参数说明**
|
||
|
||
| 参数 | 作用 | 效果 |
|
||
|------|------|------|
|
||
| `-s` | 去除符号表 | 减小文件大小 |
|
||
| `-w` | 去除 DWARF 调试信息 | 减小文件大小 |
|
||
| `-H=windowsgui` | **关键** - 设置为 Windows GUI 子系统 | 隐藏控制台窗口 |
|
||
|
||
---
|
||
|
||
## 📊 **对比**
|
||
|
||
| 编译方式 | 文件大小 | 控制台窗口 | 适用场景 |
|
||
|----------|----------|------------|----------|
|
||
| 无参数 | ~38 MB | ❌ 显示 | 开发调试 |
|
||
| `-s -w` | ~32 MB | ❌ 显示 | 开发调试 |
|
||
| `-s -w -H=windowsgui` | ~31 MB | ✅ 隐藏 | **正式发布** ✨ |
|
||
|
||
---
|
||
|
||
## 💡 **常见问题**
|
||
|
||
### Q: 隐藏控制台后如何查看日志？
|
||
|
||
**A**: 有三种方式：
|
||
|
||
1. **查看日志文件**:
|
||
```bash
|
||
Get-Content logs\meshray.log -Tail 50
|
||
```
|
||
|
||
2. **通过系统托盘**:
|
||
- 右键点击托盘图标
|
||
- 选择 "打开日志"
|
||
|
||
3. **实时监控**:
|
||
```bash
|
||
tail -f logs\meshray.log
|
||
```
|
||
|
||
---
|
||
|
||
### Q: 程序崩溃了怎么办？
|
||
|
||
**A**:
|
||
|
||
1. **重新编译为 Debug 模式**:
|
||
```bash
|
||
go build -o meshray-debug.exe ./cmd/meshray
|
||
```
|
||
|
||
2. **查看日志文件**:
|
||
```bash
|
||
Get-Content logs\meshray.log -Tail 100
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 **完整构建流程**
|
||
|
||
```bash
|
||
# Step 1: 编译前端
|
||
cd web
|
||
npm run build
|
||
cd ..
|
||
|
||
# Step 2: 清理缓存
|
||
go clean -cache
|
||
|
||
# Step 3: 编译（带 windowsgui）
|
||
go build -o meshray.exe -ldflags "-s -w -H=windowsgui" ./cmd/meshray
|
||
|
||
# Step 4: 嵌入图标（可选但推荐）
|
||
go-winres patch --in build\winres.json meshray.exe
|
||
|
||
# Step 5: 验证
|
||
(Get-Item meshray.exe).VersionInfo | Format-List
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 **最佳实践**
|
||
|
||
### 开发环境
|
||
```bash
|
||
# 保留控制台输出，方便看日志
|
||
go build -o meshray.exe ./cmd/meshray
|
||
```
|
||
|
||
### 生产环境
|
||
```bash
|
||
# 隐藏控制台，优化体积
|
||
go build -o meshray.exe -ldflags "-s -w -H=windowsgui" ./cmd/meshray
|
||
```
|
||
|
||
---
|
||
|
||
## 📚 **相关文档**
|
||
|
||
- [Windows GUI 程序编译配置指南.md](./Windows%20GUI 程序编译配置指南.md) - 详细说明
|
||
- [路由注册顺序检查清单.md](./路由注册顺序检查清单.md) - 防止路由顺序错误
|
||
|
||
---
|
||
|
||
**状态**: ✅ **已配置**
|
||
**编译命令**: `go build -o meshray.exe -ldflags "-s -w -H=windowsgui" ./cmd/meshray`
|
||
|
||
*MeshRay - 注重用户体验，从细节开始！* ✨🪟
|