乙巳年孟秋小记 - 一些感悟

# 磁山🚵‍♀️

📆 2025年08月10日 | 烟台福山区磁山地质公园
![](https://vanvlog.oss-cn-beijing.aliyuncs.com/image/cishan/IMG20250810101812.jpg)



![](https://vanvlog.oss-cn-beijing.aliyuncs.com/image/cishan/IMG20250810100731.jpg)

![](https://vanvlog.oss-cn-beijing.aliyuncs.com/image/cishan/IMG20250810095945.jpg)

![](https://vanvlog.oss-cn-beijing.aliyuncs.com/image/cishan/IMG20250810101704.jpg)

![](https://vanvlog.oss-cn-beijing.aliyuncs.com/image/cishan/mmexport1754822762230.jpg)

## 附两张周六

📆 2025年08月09日 | 烟台黄渤海新区金沙滩海滨公园
![](https://vanvlog.oss-cn-beijing.aliyuncs.com/image/cishan/IMG20250809154001.jpg)

![](https://vanvlog.oss-cn-beijing.aliyuncs.com/image/cishan/IMG20250809155511.jpg)

一个周末 - 磁山

## 使用 Microsoft Store 安装应用
### Microsoft Store 的默认安装位置
通过 Microsoft Store 安装的应用(包括UWP应用和传统Win32应用)都会被安装到
```PowerShell
%LOCALAPPDATA%\Microsoft\WindowsApps
```

## 使用 Winget 安装应用
### Winget 的默认安装位置
Winget 的安装应用的路径取决于两个因素：
1. 安装程序类型：传统桌面应用(.exe或.msi)还是便携式应用(portable)
2. 安装身份类型：用户身份安装(`--user`)还是管理员身份安装(`--machine`)



对于便携式应用程序(比如sqlite)：winget通常会将程序安装到 
```PowerShell
%LOCALAPPDATA%\Microsoft\WinGet\Packages
```
对于传统桌面应用：winget通常会调用该应用的官方安装程序来进行安装。所以最终安装路径取决于用户。但是！
winget通常会使用**静默安装**(静默安装会跳过所有用户界面的交互，比如选择安装路径、勾选组件、阅读许可协议等步骤)的方式，也就是说会安装到应用程序开发者指定的默认路径(开发者在制作安装程序时，通常会提供静默安装的命令行参数)。

如何区分安装程序类型是传统桌面应用还是便携式，使用 winget 的 `show` 命令可以查看包的详细信息，例如：
```PowerShell
PS E:\> winget show --id SQLite.SQLite
已找到 SQLite [SQLite.SQLite]
版本: 3.50.4
发布者: SQLite
发布服务器 URL: https://sqlite.org/
发布服务器支持 URL: https://sqlite.org/support.html
作者: Dwayne Richard Hipp
描述:
  SQLite is an in-process library that implements a self-contained, serverless, zero-configuration, transactional SQL database engine.
  SQLite is an embedded SQL database engine.
  Unlike most other SQL databases, SQLite does not have a separate server process.
  SQLite reads and writes directly to ordinary disk files.
  A complete SQL database with multiple tables, indices, triggers, and views, is contained in a single disk file.
主页: https://sqlite.org/
许可证: Public Domain
版权 URL: https://sqlite.org/copyright.html
文档:
  FAQ: https://sqlite.org/faq.html
标记：
  sqlite
  sqlite3
安装：
  安装程序类型： portable (zip)
  安装程序 URL： https://www.sqlite.org/2025/sqlite-tools-win-x64-3500400.zip
  安装程序 SHA256： 8ce18347ea86a1ce65f33b533d2f144d8d1237140529fbf818574ca11fa13ad5
  发布日期: 2025-07-30
  支持脱机分发: true
```
这样可以看到详细安装包信息，包括安装程序类型：`portable (zip)`，这是便携式安装包（一个zip压缩包）

windows软件管理

*📅 2024年03月09日 ｜ 📍 青岛高新区*

![生活有梦想](https://vanvlog.oss-cn-beijing.aliyuncs.com/shenghuo.jpg)



# 🌊周末去金沙滩散散心
*📆 2024年03月31日 | 🏖️青岛金沙滩*

![](https://www.notion.so/image/attachment%3Aeba5dea6-cdca-4d0d-b4c0-7f248df084fb%3AIMG20240331131936.jpg?table=block&id=2445700b-a9fe-80ed-9f6b-edef8bec35a6&spaceId=9fe5d463-f46e-48d2-ba40-f5cd64f46fc2&width=2000&userId=&cache=v2)

![](https://www.notion.so/image/attachment%3Ae7b02ac5-1f32-45f8-9c20-cf0429537014%3AIMG20240331133051.jpg?table=block&id=2445700b-a9fe-8084-94a7-e200270103d7&spaceId=9fe5d463-f46e-48d2-ba40-f5cd64f46fc2&width=2000&userId=&cache=v2)

![青岛金沙滩20240331](https://vanvlog.oss-cn-beijing.aliyuncs.com/jinshatan.jpg)

# ⛰️爬个崂山
*📆 2024年07月28日 | ⛰️青岛崂山区*

![](https://www.notion.so/image/attachment%3A06b1114f-6195-45a7-bdb9-8771d95c3032%3AIMG20240728124443.jpg?table=block&id=2445700b-a9fe-8089-b060-e2aee487d034&spaceId=9fe5d463-f46e-48d2-ba40-f5cd64f46fc2&width=2000&userId=&cache=v2)

# 
*📆 2024年08月13日 | 🌍青岛开发区金都华府*

出门吃饭拍到的
![](https://www.notion.so/image/attachment%3Af48a91f8-f850-40fc-8e05-82e73e962068%3AIMG20240813183923.jpg?table=block&id=2445700b-a9fe-80ea-97ee-e4a67b05649d&spaceId=9fe5d463-f46e-48d2-ba40-f5cd64f46fc2&width=2000&userId=&cache=v2)

# 和朋友吃个无锡小笼包
*📆 2024年10月26日 | 🌍无锡锡笼记*

12块一个的小笼包 就吃一次奢侈一把一人要了两笼
![锡笼记](https://www.notion.so/image/attachment%3A940dc524-c55a-4047-9818-467988b42ebc%3AIMG20241026121501.jpg?table=block&id=2445700b-a9fe-8066-87b6-d2d0c3db446b&spaceId=9fe5d463-f46e-48d2-ba40-f5cd64f46fc2&width=1420&userId=&cache=v2)

# 🐶遛遛狗
*📆 2024年11月26日 | 🌍德州齐河县*

![照片Test](https://www.notion.so/image/attachment%3Acbb5d547-1a58-4bf6-b975-d5fbdddd9413%3AIMG20241126164012.jpg?table=block&id=2445700b-a9fe-8036-9104-d3dceb85d849&spaceId=9fe5d463-f46e-48d2-ba40-f5cd64f46fc2&width=2000&userId=&cache=v2)

记录一下自己的2024年

# MadLog - 高性能C++/Qt日志系统

## 📖 简介

MadLog是一个功能强大、高性能的C++/Qt日志系统，提供了灵活的日志记录、格式化和输出功能。该系统采用现代C++设计模式，支持多种输出方式，适用于各种规模的Qt应用程序。



## ✨ 主要特性

### 🎯 核心功能
- **多级别日志**：支持Trace、Debug、Info、Warn、Error、Critical六个级别
- **多输出器**：支持控制台、文件、GUI控件、Qt控制台等多种输出方式
- **自定义格式**：灵活的日志格式化系统，支持自定义模式
- **线程安全**：完全线程安全的设计，支持多线程环境
- **高性能**：优化的内存管理和批量输出机制

### 🔧 便捷宏系统
- **简单易用**：提供丰富的日志宏，使用简单
- **流式日志**：支持C++流式语法，类型安全且高性能
- **条件日志**：支持条件输出，避免不必要的性能开销
- **函数跟踪**：自动函数进入/退出跟踪
- **性能测量**：内置性能测量宏，方便性能分析
- **作用域跟踪**：RAII风格的作用域跟踪

### 📤 多种输出器
1. **控制台输出器** (`MadConsoleSink`)
   - 支持彩色输出
   - 错误级别自动输出到stderr
   
2. **文件输出器** (`MadFileSink`)
   - 文件轮转功能
   - 自动备份管理
   - 定时刷新
   
3. **QTextEdit输出器** (`MadTextEditSink`)
   - HTML格式支持
   - 彩色文本显示
   - 行数限制和自动滚动
   
4. **QPlainTextEdit输出器** (`MadPlainTextEditSink`)
   - 纯文本格式
   - 高性能显示
   - 彩色文本支持
   
5. **Qt控制台输出器** (`MadQtConsoleSink`)
   - 集成Qt日志系统
   - 支持Qt日志分类
   - 与Qt Creator调试器完美集成

## 🚀 快速开始

### 1. 项目集成

在你的`.pro`文件中添加：
```qmake
include(MadLog/MadLog.pri)
```

### 2. 基础使用

```cpp
#include "madlogmacros.h"
#include "madconsolesink.h"
#include "madlogmanager.h"

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    
    // 设置日志系统
    auto manager = MadLogManager::instance();
    auto logger = manager->getLogger("default");
    
    // 添加控制台输出器
    auto consoleSink = QSharedPointer<MadConsoleSink>::create();
    logger->addSink(consoleSink);
    
    // 使用传统日志宏
    MAD_INFO("应用程序启动");
    MAD_DEBUG("调试信息");
    MAD_WARN("警告信息");
    MAD_ERROR("错误信息");
    
    // 使用流式日志（推荐）
    logger->info(__FILE__, __LINE__, __FUNCTION__) << "应用程序启动";
    logger->debug(__FILE__, __LINE__, __FUNCTION__) << "用户ID: " << 12345;
    logger->warn(__FILE__, __LINE__, __FUNCTION__) << "连接超时，重试次数: " << 3;
    logger->error(__FILE__, __LINE__, __FUNCTION__) << "文件不存在: " << "config.ini";
    
    return app.exec();
}
```

### 3. 流式日志使用

流式日志提供了更现代、类型安全的日志记录方式：

```cpp
#include "madlogger.h"

void demonstrateStreamLogging()
{
    auto logger = MAD_DEFAULT_LOGGER();
    
    // 基础流式日志
    logger->info(__FILE__, __LINE__, __FUNCTION__) << "用户登录成功";
    logger->debug(__FILE__, __LINE__, __FUNCTION__) << "处理请求ID: " << 12345;
    
    // 支持多种数据类型
    QString username = "admin";
    int userId = 1001;
    double responseTime = 123.45;
    
    logger->info(__FILE__, __LINE__, __FUNCTION__) 
        << "用户: " << username 
        << ", ID: " << userId 
        << ", 响应时间: " << responseTime << "ms";
    
    // 支持QStringList
    QStringList permissions = {"read", "write", "admin"};
    logger->debug(__FILE__, __LINE__, __FUNCTION__) 
        << "用户权限: " << permissions;
    
    // 支持Qt容器类型
    QList<int> numbers = {1, 2, 3, 4, 5};
    logger->trace(__FILE__, __LINE__, __FUNCTION__) 
        << "处理数字列表，大小: " << numbers.size();
}
```

#### 流式日志优势
- **类型安全**：编译时检查类型，避免格式化错误
- **性能优化**：只在需要时构造字符串
- **简洁语法**：无需手动格式化字符串
- **自动管理**：RAII风格，自动处理资源
- **扩展性强**：支持自定义类型的operator<<重载

### 4. 高级配置

```cpp
#include "madlogmacros.h"
#include "madconsolesink.h"
#include "madfilesink.h"
#include "madqtconsolesink.h"
#include "madlogpatternformatter.h"

void setupAdvancedLogging()
{
    auto manager = MadLogManager::instance();
    
    // 设置全局日志级别
    manager->setGlobalLevel(MadLogLevel::Debug);
    
    // 创建自定义格式化器
    auto formatter = QSharedPointer<MadLogPatternFormatter>::create(
        "[%time%] [%level%] [%thread%] [%logger%] %file%:%line% - %msg%");
    
    // 创建多个输出器
    auto consoleSink = QSharedPointer<MadConsoleSink>::create(formatter);
    auto fileSink = QSharedPointer<MadFileSink>::create("logs/app.log", formatter);
    auto qtConsoleSink = QSharedPointer<MadQtConsoleSink>::create(formatter);
    
    // 配置文件输出器
    fileSink->setMaxFileSize(10 * 1024 * 1024); // 10MB
    fileSink->setMaxBackupCount(5);
    
    // 配置Qt控制台输出器
    qtConsoleSink->setCategoryName("myapp");
    qtConsoleSink->setUseQtCategories(true);
    
    // 获取日志记录器并添加输出器
    auto logger = manager->getLogger("default");
    logger->addSink(consoleSink);
    logger->addSink(fileSink);
    logger->addSink(qtConsoleSink);
}
```

## 📚 详细使用指南

### 日志宏使用

#### 基础日志宏
```cpp
MAD_TRACE("跟踪信息");
MAD_DEBUG("调试信息");
MAD_INFO("一般信息");
MAD_WARN("警告信息");
MAD_ERROR("错误信息");
MAD_CRITICAL("严重错误");
```

#### 格式化日志宏
```cpp
int userId = 12345;
QString userName = "张三";
MAD_INFO_F("用户登录: ID=%d, 姓名=%s", userId, userName.toUtf8().constData());
```

#### 条件日志宏
```cpp
bool debugMode = true;
MAD_DEBUG_IF(debugMode, "调试模式已启用");
```

#### 指定日志记录器
```cpp
auto networkLogger = MAD_LOGGER("network");
MAD_INFO_L(networkLogger, "网络连接已建立");
```

#### 函数跟踪
```cpp
void myFunction()
{
    MAD_FUNCTION_ENTER();  // 函数进入
    
    // 函数逻辑...
    
    MAD_FUNCTION_EXIT();   // 函数退出
}

// 或者使用作用域跟踪（推荐）
void myFunction()
{
    MAD_SCOPE_TRACKER();   // 自动跟踪整个函数作用域
    
    // 函数逻辑...
    // 函数结束时自动记录退出
}
```

#### 性能测量
```cpp
void performanceTest()
{
    MAD_PERF_START(database_query);
    
    // 执行数据库查询...
    
    MAD_PERF_END(database_query);  // 自动输出执行时间
}
```

### GUI集成示例

```cpp
#include "madtexteditsink.h"
#include "madplaintexteditsink.h"

class MainWindow : public QMainWindow
{
public:
    MainWindow(QWidget* parent = nullptr) : QMainWindow(parent)
    {
        setupUI();
        setupLogging();
    }
    
private:
    void setupLogging()
    {
        auto logger = MAD_DEFAULT_LOGGER();
        
        // 添加QTextEdit输出器
        auto textEditSink = QSharedPointer<MadTextEditSink>::create(m_logTextEdit);
        textEditSink->setMaxLines(1000);
        textEditSink->setColorEnabled(true);
        logger->addSink(textEditSink);
        
        // 添加QPlainTextEdit输出器
        auto plainTextSink = QSharedPointer<MadPlainTextEditSink>::create(m_logPlainTextEdit);
        plainTextSink->setMaxLines(1000);
        logger->addSink(plainTextSink);
    }
    
    QTextEdit* m_logTextEdit;
    QPlainTextEdit* m_logPlainTextEdit;
};
```

### 自定义格式化器

```cpp
class CustomFormatter : public MadLogFormatter
{
public:
    QString format(const MadLogMessage& msg) override
    {
        return QString("[%1] %2: %3")
            .arg(QDateTime::fromMSecsSinceEpoch(msg.timestamp).toString("hh:mm:ss"))
            .arg(madLogLevelToString(msg.level))
            .arg(msg.message);
    }
};

// 使用自定义格式化器
auto customFormatter = QSharedPointer<CustomFormatter>::create();
auto sink = QSharedPointer<MadConsoleSink>::create(customFormatter);
```

## 🎨 格式化模式

内置的`MadLogPatternFormatter`支持以下占位符：

| 占位符 | 描述 | 示例 |
|--------|------|------|
| `%time%` | 时间戳 | `2023-12-01 14:30:25.123` |
| `%level%` | 日志级别 | `INFO`, `ERROR` |
| `%msg%` | 日志消息 | `用户登录成功` |
| `%logger%` | 日志记录器名称 | `network`, `database` |
| `%file%` | 源文件名 | `main.cpp` |
| `%line%` | 行号 | `42` |
| `%func%` | 函数名 | `main` |
| `%thread%` | 线程ID | `12345` |

示例格式：
```cpp
"[%time%] [%level%] [%logger%] %file%:%line% - %msg%"
// 输出：[2023-12-01 14:30:25.123] [INFO] [network] main.cpp:42 - 连接建立成功
```

## 🔧 配置选项

### 文件输出器配置
```cpp
auto fileSink = QSharedPointer<MadFileSink>::create("logs/app.log");
fileSink->setMaxFileSize(50 * 1024 * 1024);  // 50MB
fileSink->setMaxBackupCount(10);             // 保留10个备份文件
fileSink->setAutoFlushInterval(1000);        // 1秒自动刷新
```

### GUI输出器配置
```cpp
auto textEditSink = QSharedPointer<MadTextEditSink>::create(textEdit);
textEditSink->setMaxLines(500);              // 最多显示500行
textEditSink->setAutoScroll(true);           // 自动滚动
textEditSink->setColorEnabled(true);         // 启用彩色显示
textEditSink->setAutoFlushInterval(100);     // 100ms刷新间隔
```

### Qt控制台输出器配置
```cpp
auto qtSink = QSharedPointer<MadQtConsoleSink>::create();
qtSink->setCategoryName("myapp.network");    // 设置Qt日志分类
qtSink->setUseQtCategories(true);            // 启用Qt分类
```

## 🏗️ 架构设计

```
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   日志宏系统    │───▶│   MadLogger      │───▶│  MadLogSink     │
│  (便捷接口)     │    │  (日志记录器)    │    │  (输出接口)     │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                │                        │
                                ▼                        ▼
                       ┌──────────────────┐    ┌─────────────────┐
                       │ MadLogManager    │    │ MadLogFormatter │
                       │ (管理器-单例)    │    │ (格式化接口)    │
                       └──────────────────┘    └─────────────────┘
```

### 核心组件说明

- **MadLogManager**: 单例管理器，负责创建和管理日志记录器
- **MadLogger**: 日志记录器，负责接收日志消息并分发给输出器
- **MadLogSink**: 输出器接口，定义日志输出行为
- **MadLogFormatter**: 格式化器接口，负责格式化日志消息
- **日志宏系统**: 提供便捷的日志记录接口

## 🔍 最佳实践

### 1. 日志级别使用建议
- **Trace**: 详细的程序执行跟踪，通常只在开发阶段使用
- **Debug**: 调试信息，帮助定位问题
- **Info**: 一般信息，记录程序的重要状态变化
- **Warn**: 警告信息，程序可以继续运行但需要注意
- **Error**: 错误信息，程序遇到错误但可以恢复
- **Critical**: 严重错误，程序可能无法继续正常运行

### 2. 性能优化建议
- 在生产环境中设置合适的日志级别，避免输出过多调试信息
- 使用条件日志宏避免不必要的字符串构造
- 为不同模块创建专门的日志记录器
- 合理设置文件输出器的刷新间隔

### 3. 线程安全注意事项
- 所有日志操作都是线程安全的
- GUI输出器会自动处理跨线程调用
- 避免在析构函数中使用日志宏

## 📝 更新日志

### v1.0.0
- ✅ 基础日志系统实现
- ✅ 控制台和文件输出器
- ✅ 模式格式化器
- ✅ 线程安全设计

### v1.1.0
- ✅ 添加GUI输出器（QTextEdit/QPlainTextEdit）
- ✅ 完善日志宏系统
- ✅ 添加性能测量功能
- ✅ 添加作用域跟踪功能

### v1.2.0
- ✅ 添加Qt控制台输出器
- ✅ 支持Qt日志分类
- ✅ 完善文档和示例
- ✅ 优化性能和内存使用

### v1.3.0
- ✅ 简化流式日志实现，移除独立的MadLogStream类
- ✅ 优化MadLogger类，直接支持流式操作
- ✅ 支持QStringList和Qt容器类型的流式输出
- ✅ 删除不必要的示例文件，减少代码体积
- ✅ 更新文档，添加流式日志使用指南
- ✅ 提升类型安全性和性能

## 📄 许可证

本项目采用MIT许可证，详见LICENSE文件。

## 🤝 贡献

欢迎提交Issue和Pull Request来改进这个项目！

## 📞 联系方式

如有问题或建议，请通过以下方式联系：
- 提交GitHub Issue
- 发送邮件至项目维护者

---

**MadLog** - 让日志记录变得简单而强大！ 🚀