我之前也碰到过一模一样的需求——不管是出于好奇想深挖FBX的底层结构，还是导入游戏引擎时遇到玄学问题，Blender、Maya这类DCC软件确实只会展示它们觉得你需要看到的内容，很多隐藏的配置、底层属性根本不会暴露出来。用FBX SDK来导出全量文本内容绝对是最直接有效的方案，下面给你一步步讲清楚怎么做：

一、前期准备 #

• 先下载对应版本的FBX SDK（注意和你的FBX文件版本匹配，避免兼容性问题），安装后配置好开发环境：C++项目需设置好包含目录、库目录和链接库；如果偏好Python，可以用官方提供的fbx-python-sdk绑定
• 确保你对FBX的基本节点结构有初步认知（比如根节点、子节点、属性的层级关系），这会帮你更快理解导出的文本内容

二、核心代码实现（C++示例） #

下面是一个可以递归遍历FBX所有节点、属性（包括隐藏设置）并导出到文本的完整代码，覆盖了大部分常见的属性类型：

#include <fbxsdk.h>
#include <fstream>
#include <string>

// 递归遍历所有节点并写入文本
void TraverseNode(FbxNode* pNode, std::ofstream& outFile, int indentLevel = 0) {
    // 生成缩进，提升可读性
    std::string indent(indentLevel * 4, ' ');
    outFile << indent << "Node Name: " << pNode->GetName() << " | Type: " << pNode->GetNodeAttributeType() << "\n";

    // 输出节点的所有属性（包括隐藏属性）
    FbxNodeAttribute* pAttr = pNode->GetNodeAttribute();
    if (pAttr) {
        outFile << indent << "  Attributes:\n";
        for (int i = 0; i < pAttr->GetClassCount(); i++) {
            FbxProperty prop = pAttr->GetClassProperty(i);
            outFile << indent << "    - " << prop.GetName() << ": ";
            
            // 根据属性类型输出对应值
            FbxDataType dataType = prop.GetPropertyDataType();
            if (dataType.GetType() == FbxDataType::eBool) {
                outFile << (prop.Get<bool>() ? "True" : "False");
            } else if (dataType.GetType() == FbxDataType::eInt) {
                outFile << prop.Get<int>();
            } else if (dataType.GetType() == FbxDataType::eDouble) {
                outFile << prop.Get<double>();
            } else if (dataType.GetType() == FbxDataType::eString) {
                outFile << "\"" << prop.Get<FbxString>() << "\"";
            } else {
                // 处理复杂类型（比如矩阵、数组、动画曲线等）
                outFile << "[Complex Type: " << dataType.GetName() << "]";
            }
            outFile << "\n";
        }
    }

    // 输出节点变换信息（导入引擎时的高频问题点）
    outFile << indent << "  Transform:\n";
    FbxVector4 trans = pNode->LclTranslation.Get();
    outFile << indent << "    Translation: " << trans[0] << ", " << trans[1] << ", " << trans[2] << "\n";
    FbxVector4 rot = pNode->LclRotation.Get();
    outFile << indent << "    Rotation: " << rot[0] << ", " << rot[1] << ", " << rot[2] << "\n";
    FbxVector4 scale = pNode->LclScaling.Get();
    outFile << indent << "    Scaling: " << scale[0] << ", " << scale[1] << ", " << scale[2] << "\n";

    // 递归遍历子节点，确保没有遗漏
    for (int i = 0; i < pNode->GetChildCount(); i++) {
        TraverseNode(pNode->GetChild(i), outFile, indentLevel + 1);
    }
}

int main(int argc, char** argv) {
    if (argc != 3) {
        printf("Usage: FBXToText <input.fbx> <output.txt>\n");
        return 1;
    }

    // 初始化FBX管理器（SDK核心组件）
    FbxManager* pManager = FbxManager::Create();
    FbxIOSettings* pIOSettings = FbxIOSettings::Create(pManager, IOSROOT);
    pManager->SetIOSettings(pIOSettings);

    // 创建导入器并初始化
    FbxImporter* pImporter = FbxImporter::Create(pManager, "");
    bool importStatus = pImporter->Initialize(argv[1], -1, pManager->GetIOSettings());
    if (!importStatus) {
        printf("Import failed: %s\n", pImporter->GetStatus().GetErrorString());
        pImporter->Destroy();
        pManager->Destroy();
        return 1;
    }

    // 导入FBX到场景对象
    FbxScene* pScene = FbxScene::Create(pManager, "Scene");
    pImporter->Import(pScene);
    pImporter->Destroy();

    // 打开输出文件并写入内容
    std::ofstream outFile(argv[2]);
    if (!outFile.is_open()) {
        printf("Failed to open output file\n");
        pScene->Destroy();
        pManager->Destroy();
        return 1;
    }

    outFile << "===== FBX Full Content Dump =====\n";
    TraverseNode(pScene->GetRootNode(), outFile);

    // 清理资源
    outFile.close();
    pScene->Destroy();
    pManager->Destroy();

    printf("Successfully dumped FBX content to %s\n", argv[2]);
    return 0;
}

三、Python版本简化示例 #

如果不想写C++，可以用Python版本的FBX SDK快速实现，代码更简洁：

import fbx

def traverse_node(node, out_file, indent_level=0):
    indent = '    ' * indent_level
    out_file.write(f"{indent}Node Name: {node.GetName()} | Type: {node.GetNodeAttributeType()}\n")
    
    # 遍历节点属性
    attr = node.GetNodeAttribute()
    if attr:
        out_file.write(f"{indent}  Attributes:\n")
        for i in range(attr.GetClassCount()):
            prop = attr.GetClassProperty(i)
            prop_name = prop.GetName()
            prop_type = prop.GetPropertyDataType().GetName()
            try:
                # 适配常见属性类型
                if prop_type == 'bool':
                    value = prop.GetBool()
                elif prop_type == 'int':
                    value = prop.GetInt()
                elif prop_type == 'double':
                    value = prop.GetDouble()
                elif prop_type == 'string':
                    value = f'"{prop.GetString()}"'
                else:
                    value = f'[Complex Type: {prop_type}]'
                out_file.write(f"{indent}    - {prop_name}: {value}\n")
            except:
                out_file.write(f"{indent}    - {prop_name}: [Unreadable Value]\n")
    
    # 输出变换信息
    out_file.write(f"{indent}  Transform:\n")
    trans = node.LclTranslation.Get()
    out_file.write(f"{indent}    Translation: {trans[0]}, {trans[1]}, {trans[2]}\n")
    rot = node.LclRotation.Get()
    out_file.write(f"{indent}    Rotation: {rot[0]}, {rot[1]}, {rot[2]}\n")
    scale = node.LclScaling.Get()
    out_file.write(f"{indent}    Scaling: {scale[0]}, {scale[1]}, {scale[2]}\n")
    
    # 递归处理子节点
    for i in range(node.GetChildCount()):
        traverse_node(node.GetChild(i), out_file, indent_level + 1)

def fbx_to_text(input_path, output_path):
    # 初始化FBX环境
    manager = fbx.FbxManager.Create()
    ios = fbx.FbxIOSettings.Create(manager, fbx.IOSROOT)
    manager.SetIOSettings(ios)
    
    # 导入FBX文件
    importer = fbx.FbxImporter.Create(manager, "")
    if not importer.Initialize(input_path, -1, manager.GetIOSettings()):
        print(f"Import failed: {importer.GetStatus().GetErrorString()}")
        return
    
    scene = fbx.FbxScene.Create(manager, "Scene")
    importer.Import(scene)
    importer.Destroy()
    
    # 写入文本文件
    with open(output_path, 'w', encoding='utf-8') as f:
        f.write("===== FBX Full Content Dump =====\n")
        traverse_node(scene.GetRootNode(), f)
    
    # 清理资源
    scene.Destroy()
    manager.Destroy()
    print(f"Successfully dumped content to {output_path}")

# 使用示例
fbx_to_text("your_input.fbx", "fbx_dump.txt")

四、实用排查技巧 #

• 导出正常和异常FBX的文本后，用文件对比工具（比如VS Code的内置对比、Beyond Compare）对比差异，重点关注节点结构、属性值、变换数据，很容易定位问题根源
• 如果需要查看动画曲线、骨骼权重这类复杂数据，可以在代码中扩展对应类型的输出逻辑，把数组或矩阵转成可读的文本格式

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