refactor(logging): implement unified Logger system to replace console calls

- Add Logger utility with tagged output and environment-based control - Configure Babel to remove console calls in production builds - Replace all console.* calls across stores, services, and components with Logger - Enable development-only logging with formatted output and component tags - Optimize production builds by eliminating all logging code
2026-02-04 03:36:29 +08:00 · 2025-08-15 22:57:38 +08:00
parent 836285dbd5
commit e57466c8c1
25 changed files with 404 additions and 200 deletions
--- a/utils/Logger.ts
+++ b/utils/Logger.ts
@@ -0,0 +1,149 @@
+/**
+ * 统一日志管理器
+ * 在开发环境输出完整日志，生产环境移除所有日志代码
+ */
+
+export enum LogLevel {
+  DEBUG = 0,
+  INFO = 1,
+  WARN = 2,
+  ERROR = 3,
+}
+
+interface LoggerOptions {
+  tag?: string;
+  level?: LogLevel;
+}
+
+class LoggerClass {
+  private minLevel: LogLevel = LogLevel.DEBUG;
+
+  /**
+   * 设置最小日志级别
+   */
+  setMinLevel(level: LogLevel): void {
+    if (__DEV__) {
+      this.minLevel = level;
+    }
+  }
+
+  /**
+   * 格式化日志输出
+   */
+  private formatMessage(level: string, tag: string | undefined, message: any, ...args: any[]): void {
+    if (!__DEV__) return;
+
+    const timestamp = new Date().toISOString().substr(11, 12);
+    const prefix = tag ? `[${timestamp}][${level}][${tag}]` : `[${timestamp}][${level}]`;
+    
+    switch (level) {
+      case 'DEBUG':
+        console.log(prefix, message, ...args);
+        break;
+      case 'INFO':
+        console.info(prefix, message, ...args);
+        break;
+      case 'WARN':
+        console.warn(prefix, message, ...args);
+        break;
+      case 'ERROR':
+        console.error(prefix, message, ...args);
+        break;
+    }
+  }
+
+  /**
+   * 调试级别日志
+   */
+  debug(message: any, ...args: any[]): void;
+  debug(options: LoggerOptions, message: any, ...args: any[]): void;
+  debug(optionsOrMessage: LoggerOptions | any, message?: any, ...args: any[]): void {
+    if (!__DEV__) return;
+
+    if (this.minLevel > LogLevel.DEBUG) return;
+
+    if (typeof optionsOrMessage === 'object' && optionsOrMessage.tag !== undefined) {
+      const options = optionsOrMessage as LoggerOptions;
+      this.formatMessage('DEBUG', options.tag, message, ...args);
+    } else {
+      this.formatMessage('DEBUG', undefined, optionsOrMessage, message, ...args);
+    }
+  }
+
+  /**
+   * 信息级别日志
+   */
+  info(message: any, ...args: any[]): void;
+  info(options: LoggerOptions, message: any, ...args: any[]): void;
+  info(optionsOrMessage: LoggerOptions | any, message?: any, ...args: any[]): void {
+    if (!__DEV__) return;
+
+    if (this.minLevel > LogLevel.INFO) return;
+
+    if (typeof optionsOrMessage === 'object' && optionsOrMessage.tag !== undefined) {
+      const options = optionsOrMessage as LoggerOptions;
+      this.formatMessage('INFO', options.tag, message, ...args);
+    } else {
+      this.formatMessage('INFO', undefined, optionsOrMessage, message, ...args);
+    }
+  }
+
+  /**
+   * 警告级别日志
+   */
+  warn(message: any, ...args: any[]): void;
+  warn(options: LoggerOptions, message: any, ...args: any[]): void;
+  warn(optionsOrMessage: LoggerOptions | any, message?: any, ...args: any[]): void {
+    if (!__DEV__) return;
+
+    if (this.minLevel > LogLevel.WARN) return;
+
+    if (typeof optionsOrMessage === 'object' && optionsOrMessage.tag !== undefined) {
+      const options = optionsOrMessage as LoggerOptions;
+      this.formatMessage('WARN', options.tag, message, ...args);
+    } else {
+      this.formatMessage('WARN', undefined, optionsOrMessage, message, ...args);
+    }
+  }
+
+  /**
+   * 错误级别日志
+   */
+  error(message: any, ...args: any[]): void;
+  error(options: LoggerOptions, message: any, ...args: any[]): void;
+  error(optionsOrMessage: LoggerOptions | any, message?: any, ...args: any[]): void {
+    if (!__DEV__) return;
+
+    if (this.minLevel > LogLevel.ERROR) return;
+
+    if (typeof optionsOrMessage === 'object' && optionsOrMessage.tag !== undefined) {
+      const options = optionsOrMessage as LoggerOptions;
+      this.formatMessage('ERROR', options.tag, message, ...args);
+    } else {
+      this.formatMessage('ERROR', undefined, optionsOrMessage, message, ...args);
+    }
+  }
+
+  /**
+   * 创建带标签的日志实例
+   */
+  withTag(tag: string): LoggerClass {
+    const taggedLogger = new LoggerClass();
+    taggedLogger.minLevel = this.minLevel;
+    
+    const originalDebug = taggedLogger.debug.bind(taggedLogger);
+    const originalInfo = taggedLogger.info.bind(taggedLogger);
+    const originalWarn = taggedLogger.warn.bind(taggedLogger);
+    const originalError = taggedLogger.error.bind(taggedLogger);
+
+    taggedLogger.debug = (message: any, ...args: any[]) => originalDebug({ tag }, message, ...args);
+    taggedLogger.info = (message: any, ...args: any[]) => originalInfo({ tag }, message, ...args);
+    taggedLogger.warn = (message: any, ...args: any[]) => originalWarn({ tag }, message, ...args);
+    taggedLogger.error = (message: any, ...args: any[]) => originalError({ tag }, message, ...args);
+
+    return taggedLogger;
+  }
+}
+
+export const Logger = new LoggerClass();
+export default Logger;