uniapp 本地日志
uniapp 本地日志实现方法
使用 console 输出日志
uniapp 支持标准的 console API,可在开发时输出日志到控制台。console.log()、console.error() 等方法在 H5 和微信小程序中可直接使用。
日志会在开发者工具的调试面板中显示,方便调试。
写入本地文件
通过 uni.getFileSystemManager() 获取文件系统管理器,将日志写入本地文件。
适用于需要持久化存储日志的场景,如用户操作记录或错误追踪。
const fs = uni.getFileSystemManager();
const logContent = 'This is a log message';
fs.writeFile({
filePath: `${uni.env.USER_DATA_PATH}/log.txt`,
data: logContent,
encoding: 'utf8',
success: () => { console.log('Log saved'); },
fail: (err) => { console.error('Save log failed', err); }
});
使用 uni.setStorage 存储日志
通过 uni.setStorage 将日志存储在本地缓存中,适合少量日志的临时存储。
日志以键值对形式保存,读取时通过 uni.getStorage 获取。
let logs = uni.getStorageSync('app_logs') || [];
logs.push('New log entry');
uni.setStorageSync('app_logs', logs);
集成第三方日志库
引入第三方日志库如 log4js 或 winston 增强日志功能。
需通过 npm 安装并在项目中配置,支持分级日志、格式化输出等功能。
const log4js = require('log4js');
log4js.configure({
appenders: { file: { type: 'file', filename: 'logs.log' } },
categories: { default: { appenders: ['file'], level: 'debug' } }
});
const logger = log4js.getLogger();
logger.debug('Debug message');
注意事项
- 文件系统 API 在部分平台(如 H5)可能受限,需测试目标平台的兼容性。
- 日志文件过大可能影响性能,建议定期清理或分片存储。
- 敏感信息避免记录在日志中,防止隐私泄露。
通过以上方法可实现 uniapp 的本地日志功能,根据需求选择适合的方案。







