crypto-js JavaScript 加密标准库使用指南

3. 快速上手 crypto-js：在项目中使用

3.1 安装 crypto-js

npm install crypto-js

3.2 基本使用

// 引入整个库
const CryptoJS = require("crypto-js");

// 或者按需引入
const SHA256 = require("crypto-js/sha256");
const AES = require("crypto-js/aes");
const encUtf8 = require("crypto-js/enc-utf8");

// 哈希计算
const hash = SHA256("Hello World").toString();
console.log("SHA256 Hash:", hash);

// AES 加密解密
const secretKey = "my-secret-key";
const encrypted = AES.encrypt("Hello World", secretKey).toString();
const decrypted = AES.decrypt(encrypted, secretKey).toString(encUtf8);
console.log("Encrypted:", encrypted);
console.log("Decrypted:", decrypted);

3.3 高级使用

const CryptoJS = require("crypto-js");

// 自定义 AES 配置
const message = "Hello World";
const key = CryptoJS.enc.Utf8.parse("1234567890123456"); // 16 位密钥
const iv = CryptoJS.enc.Utf8.parse("1234567890123456"); // 16 位初始向量

// 加密
const encrypted = CryptoJS.AES.encrypt(message, key, {
    iv: iv,
    mode: CryptoJS.mode.CBC,
    padding: CryptoJS.pad.Pkcs7
});
console.log("密文:", encrypted.toString());

// 解密
const decrypted = CryptoJS.AES.decrypt(encrypted, key, {
    iv: iv,
    mode: CryptoJS.mode.CBC,
    padding: CryptoJS.pad.Pkcs7
});
console.log("明文:", decrypted.toString(CryptoJS.enc.Utf8));

4. crypto-js 核心算法详解

4.1 哈希算法（Hash Algorithms）

const CryptoJS = require("crypto-js");
const message = "Hello World";

// MD5
console.log("MD5:", CryptoJS.MD5(message).toString());
// SHA1
console.log("SHA1:", CryptoJS.SHA1(message).toString());
// SHA256
console.log("SHA256:", CryptoJS.SHA256(message).toString());
// SHA512
console.log("SHA512:", CryptoJS.SHA512(message).toString());

4.2 对称加密算法（Symmetric Encryption）

const CryptoJS = require("crypto-js");
const message = "Hello World";
const secretKey = "my-secret-key";

// AES 加密
const encrypted = CryptoJS.AES.encrypt(message, secretKey).toString();
console.log("AES 加密:", encrypted);

// AES 解密
const decrypted = CryptoJS.AES.decrypt(encrypted, secretKey);
console.log("AES 解密:", decrypted.toString(CryptoJS.enc.Utf8));

// DES 加密
const desEncrypted = CryptoJS.DES.encrypt(message, secretKey).toString();
console.log("DES 加密:", desEncrypted);

// DES 解密
const desDecrypted = CryptoJS.DES.decrypt(desEncrypted, secretKey);
console.log("DES 解密:", desDecrypted.toString(CryptoJS.enc.Utf8));

4.3 编码解码（Encoding/Decoding）

const CryptoJS = require("crypto-js");
const message = "Hello World";

// Base64 编码
const base64Encoded = CryptoJS.enc.Base64.stringify(CryptoJS.enc.Utf8.parse(message));
console.log("Base64 编码:", base64Encoded);

// Base64 解码
const base64Decoded = CryptoJS.enc.Base64.parse(base64Encoded).toString(CryptoJS.enc.Utf8);
console.log("Base64 解码:", base64Decoded);

// Hex 编码
const hexEncoded = CryptoJS.enc.Hex.stringify(CryptoJS.enc.Utf8.parse(message));
console.log("Hex 编码:", hexEncoded);

// Hex 解码
const hexDecoded = CryptoJS.enc.Hex.parse(hexEncoded).toString(CryptoJS.enc.Utf8);
console.log("Hex 解码:", hexDecoded);

5. crypto-js 与其他工具的集成

数据流程通常如下：原始数据 -> crypto-js 处理（哈希/加密/编码）-> 安全传输或存储。

6. 实际应用场景

6.1 用户密码加密存储

const CryptoJS = require("crypto-js");

// 用户注册时加密密码
function hashPassword(password) {
    // 使用 SHA256 + 盐值
    const salt = "my-salt-value";
    return CryptoJS.SHA256(password + salt).toString();
}

// 验证密码
function verifyPassword(inputPassword, storedHash) {
    const hashedInput = hashPassword(inputPassword);
    return hashedInput === storedHash;
}

const userPassword = "mySecretPassword123";
const hashedPassword = hashPassword(userPassword);
console.log("加密后的密码:", hashedPassword);

6.2 API 请求数据加密

const CryptoJS = require("crypto-js");

// 加密请求参数
function encryptData(data, secretKey) {
    return CryptoJS.AES.encrypt(JSON.stringify(data), secretKey).toString();
}

// 解密响应数据
function decryptData(encryptedData, secretKey) {
    const bytes = CryptoJS.AES.decrypt(encryptedData, secretKey);
    return JSON.parse(bytes.toString(CryptoJS.enc.Utf8));
}

// 使用示例
const apiData = { username: "john", email: "[email protected]" };
const secretKey = "api-secret-key";
const encrypted = encryptData(apiData, secretKey);
console.log("加密数据:", encrypted);
const decrypted = decryptData(encrypted, secretKey);
console.log("解密数据:", decrypted);

6.3 本地存储数据加密

const CryptoJS = require("crypto-js");

// 加密存储
function setEncryptedItem(key, value, secretKey) {
    const encrypted = CryptoJS.AES.encrypt(JSON.stringify(value), secretKey).toString();
    localStorage.setItem(key, encrypted);
}

// 解密读取
function getEncryptedItem(key, secretKey) {
    const encrypted = localStorage.getItem(key);
    if (!encrypted) return null;
    try {
        const bytes = CryptoJS.AES.decrypt(encrypted, secretKey);
        return JSON.parse(bytes.toString(CryptoJS.enc.Utf8));
    } catch (error) {
        console.error("解密失败:", error);
        return null;
    }
}

// 使用示例
const userData = { name: "John", token: "abc123" };
const secretKey = "local-storage-key";
setEncryptedItem("user", userData, secretKey);
const retrievedData = getEncryptedItem("user", secretKey);
console.log("读取的数据:", retrievedData);

7. 安全注意事项和最佳实践

7.1 常见安全问题

7.2 最佳实践示例

const CryptoJS = require("crypto-js");

class SecureCrypto {
    constructor(secretKey) {
        // 使用 PBKDF2 派生密钥
        this.key = CryptoJS.PBKDF2(secretKey, "salt", { keySize: 256 / 32, iterations: 1000 });
    }

    encrypt(data) {
        const iv = CryptoJS.lib.WordArray.random(128 / 8);
        const encrypted = CryptoJS.AES.encrypt(JSON.stringify(data), this.key, {
            iv: iv,
            mode: CryptoJS.mode.CBC,
            padding: CryptoJS.pad.Pkcs7
        });
        // 将 IV 和密文一起返回
        return iv.toString() + encrypted.toString();
    }

    decrypt(encryptedData) {
        const iv = CryptoJS.enc.Hex.parse(encryptedData.substr(0, 32));
        const ciphertext = encryptedData.substr(32);
        const decrypted = CryptoJS.AES.decrypt(ciphertext, this.key, {
            iv: iv,
            mode: CryptoJS.mode.CBC,
            padding: CryptoJS.pad.Pkcs7
        });
        return JSON.parse(decrypted.toString(CryptoJS.enc.Utf8));
    }
}

// 使用示例
const crypto = new SecureCrypto("my-secret-password");
const data = { message: "Hello World" };
const encrypted = crypto.encrypt(data);
const decrypted = crypto.decrypt(encrypted);
console.log("解密结果:", decrypted);

8. 常见问题解答（FAQ）

8.1 crypto-js 和 Web Crypto API 有什么区别？

8.2 如何在浏览器中使用 crypto-js？

<!-- CDN 方式 -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js"></script>
<script>
    const hash = CryptoJS.SHA256("Hello World").toString();
    console.log(hash);
</script>

<!-- ES6 模块方式 -->
<script type="module">
    import CryptoJS from 'https://cdn.skypack.dev/crypto-js';
    const hash = CryptoJS.SHA256("Hello World").toString();
    console.log(hash);
</script>

8.3 crypto-js 有性能问题吗？

✅ 对于大多数应用场景，crypto-js 的性能是足够的。如果对性能有极高要求，可以考虑：

1. 使用 Web Crypto API（浏览器环境）
2. 使用 Node.js 原生 crypto 模块（Node.js 环境）
3. 使用 WebAssembly 版本的加密库

9. 总结

加密不是什么黑科技，但它能让你的应用变得无比安全。crypto-js 就是那个帮你搞定一切的'加密专家'。

别再手动实现加密算法了，别再为兼容性头疼了，别再担心安全性问题了！

交给 crypto-js 吧，你只管写代码。