NodeJS向C++原生模块传递非ASCII字符乱码问题排查

你遇到的乱码问题主要是因为使用了v8中已经过时的字符串转换API，这些旧API在处理多字节UTF-8字符时容易出现编码错误。我来帮你分析问题并给出修复方案：

问题根源 #

你当前使用的v8::String::Utf8Value和v8::String::NewFromUtf8都是v8的旧版API，它们在处理非ASCII字符（比如中文）时，经常会因为长度计算不准确或者内存处理问题导致乱码。而且这些API现在已经被标记为废弃，不推荐继续使用。

修复方案 #

1. 使用现代v8 API正确转换UTF-8字符串 #

替换你原来的打印代码，改用Utf8Length和WriteUtf8方法来安全地将v8字符串转换为C++的std::string：

// 获取当前v8上下文
v8::Local<v8::Context> context = isolate->GetCurrentContext();

// 读取obj中的"data"字段值
v8::Local<v8::Value> dataVal = obj->Get(context, v8::String::NewFromUtf8(isolate, "data").ToLocalChecked()).ToLocalChecked();

// 先校验是否为字符串类型再进行转换
if (dataVal->IsString()) {
    v8::Local<v8::String> dataStr = dataVal.As<v8::String>();
    // 获取UTF-8编码所需的缓冲区长度
    size_t utf8Len = dataStr->Utf8Length(isolate);
    // 分配足够的缓冲区（+1用于存储字符串结束符'\0'）
    char* utf8Buffer = new char[utf8Len + 1];
    // 将v8字符串写入缓冲区
    dataStr->WriteUtf8(isolate, utf8Buffer, utf8Len + 1);
    
    // 转换为std::string并打印
    std::string resultStr(utf8Buffer);
    std::cout << resultStr << std::endl;
    
    // 记得手动释放缓冲区，避免内存泄漏
    delete[] utf8Buffer;
}

2. 解决控制台显示乱码问题 #

如果C++端已经拿到了正确的字符串，但控制台显示还是乱码，那大概率是控制台的编码和输出的UTF-8不匹配。比如Windows默认控制台编码是GBK，这时候需要手动设置为UTF-8：

// Windows平台下单独处理控制台编码
#ifdef _WIN32
#include <windows.h>
SetConsoleOutputCP(CP_UTF8);
#endif

额外建议 #

如果你正在开发Node.js原生模块，更推荐使用**Node-API（N-API）**而不是直接操作v8 API。N-API是跨Node.js版本的稳定API，不需要关心v8版本的变化，而且处理字符串编码的逻辑更简单可靠。比如用N-API获取字符串的示例：

napi_status status;
size_t strLen;
// 先获取字符串的UTF-8长度
status = napi_get_value_string_utf8(env, dataVal, nullptr, 0, &strLen);
if (status != napi_ok) { /* 这里添加错误处理逻辑 */ }

// 分配缓冲区
char* buffer = (char*)malloc(strLen + 1);
// 将JS字符串转换为UTF-8格式的C字符串
status = napi_get_value_string_utf8(env, dataVal, buffer, strLen + 1, nullptr);
if (status != napi_ok) { /* 这里添加错误处理逻辑 */ }

std::string result(buffer);
std::cout << result << std::endl;
// 释放缓冲区
free(buffer);

这样可以避免因为v8版本迭代导致的API兼容性问题，也能更稳定地处理非ASCII字符。

内容的提问来源于stack exchange，提问作者user1233963