更新记录

1.0.0（2025-08-31）

v1.0.0

初始版本发布

支持AES加密解密

支持多种哈希算法

提供工具函数

平台兼容性

uni-app(4.07)

uni-app x(4.07)

其他

hy-plugin-crypto-js 使用文档

介绍

基于 CryptoJS 的 Uniapp 加密解密插件，支持多种加密算法和哈希算法。

前置依赖

本插件需要项目中已安装 crypto-js 库。如果您的项目中尚未安装，请执行以下命令：

npm install crypto-js
# 或
yarn add crypto-js

安装

1. 将 uni_modules 文件夹复制到您的 Uniapp 项目根目录
2. 在页面中引入插件：

import cryptoService from '@/uni_modules/hy-plugin-crypto-js/common/crypto.js';

AES 加密/解密

// 加密 const encrypted = cryptoService.aesEncrypt(data, key, options);

// 解密 const decrypted = cryptoService.aesDecrypt(encryptedData, key, options);

    iv: 初始化向量（可选）
    mode: 加密模式（默认CBC）
    padding: 填充方式（默认Pkcs7）

哈希计算

// MD5 const md5Hash = cryptoService.md5(data);

// SHA256 const sha256Hash = cryptoService.sha256(data);

// SHA512 const sha512Hash = cryptoService.sha512(data);

HMAC 签名

const signature = cryptoService.hmac(data, key, algorithm);

实用工具

// Base64编码 const base64Encoded = cryptoService.base64Encode(data);

// Base64解码 const originalData = cryptoService.base64Decode(encodedData);

// 生成随机密钥 const randomKey = cryptoService.generateRandomKey(length);

// 生成随机IV const randomIV = cryptoService.generateRandomIV(length);

注意事项

1.密钥长度必须是16、24或32字节（对应AES-128、AES-192和AES-256） 2.IV长度必须与密钥长度匹配（通常16字节） 3.对于敏感数据，建议使用随机生成的密钥和IV 4.密钥管理应遵循安全最佳实践，不要硬编码在代码中

支持算法

对称加密: AES

哈希算法: MD5, SHA1, SHA256, SHA512

HMAC: HMAC-MD5, HMAC-SHA1, HMAC-SHA256, HMAC-SHA512

编码: Base64, Hex, Utf8