Go debug/pe 的 COFF 长符号名为什么不能直接读取 Name 字段

第一次直接打印 debug/pe.COFFSymbol.Name 时，最容易误判：这个字段看起来像名字，实际上只有 8 个字节。短符号名会直接放在里面；超过 8 个字符的名称，则把前四个字节置零，后四个字节改成 COFF 字符串表偏移。读取长名不能靠 string(sym.Name[:])，应把 File.StringTable 交给 sym.FullName，让它按格式完成分派，并保留偏移越界错误。

先把 COFFSymbol.Name 看成两种编码

Go 官方源码里的 COFFSymbol 使用 [8]uint8 保存 Name。COFF 规范规定：名称不超过 8 个字节时，数组里就是以零结尾的名称；需要更长空间时，前四字节为零，后四字节保存字符串表偏移。字符串表紧跟在 COFF 符号表之后，偏移不是 Go 切片下标，也不是文件头的绝对位置。

因此，直接对 Name 做字符串转换只对短名碰巧有效。长名路径里你看到的只是四个零和一个索引，打印出来可能为空、带控制字符，或者看似“乱码”。问题不在 Go 的字符串转换，而在字段本身承担了两种格式。

用 FullName 读取长名并保留偏移错误

FullName 的实现先判断前四字节是否全零，再把后四字节按小端序解释成偏移；长名走 StringTable.String，短名则读取 Name 内的零结尾内容。应用层只需要传入同一个文件解析得到的字符串表，不要自己复制一套判断逻辑。

package main

import (
    "debug/pe"
    "fmt"
    "log"
)

func printSymbols(path string) error {
    f, err := pe.Open(path)
    if err != nil {
        return fmt.Errorf("打开 COFF/PE 文件失败: %w", err)
    }
    defer f.Close() // 释放文件描述符，避免批量读取时泄漏

    for index, sym := range f.COFFSymbols {
        // FullName 会区分内嵌短名和字符串表长名
        name, err := sym.FullName(f.StringTable)
        if err != nil {
            // 偏移无效时保留原始错误，不能用 Name 字节猜一个结果
            return fmt.Errorf("读取符号 %d 的名称失败: %w", index, err)
        }
        if name == "" {
            continue // 无名称记录不当成有效符号输出
        }
        fmt.Printf("%d: %s\\n", index, name)
    }
    return nil
}

func main() {
    if err := printSymbols("sample.obj"); err != nil {
        log.Fatal(err) // 让调用方明确知道解析没有完成
    }
}

这个示例只负责读取和排障，不修改对象文件。特别要注意 FullName 返回的第二个值：字符串表偏移超出范围、表结构不完整等情况都应该让错误向上返回。把错误改成“未知符号”会让后续链接或调试问题失去定位线索。

字符串表位置和辅助记录不能混为一谈

COFF 头中的 PointerToSymbolTable 与 NumberOfSymbols 决定符号表的位置和数量；每条记录固定 18 字节，字符串表位于整个符号表之后。长名偏移指向字符串表内部的字节位置，不能从文件开头重新计算，也不能把它当作符号序号。

遍历符号时还要留意 NumberOfAuxSymbols。辅助记录紧跟主符号，但它们不是新的可打印名称。若你自己遍历 COFFSymbols，应在处理主符号后跳过对应数量；若只关心已经整理好的 f.Symbols，则让 debug/pe 的内部逻辑处理辅助记录更稳妥。

排查时固定检查这四项

• 名称类型：先检查前四字节是否全零，不要以“看起来像字符串”作为判断依据。
• 字节序：长名偏移按 COFF 约定使用小端序；不要按主机文本格式解析。
• 表来源：使用当前 pe.File 对应的 StringTable，不要跨文件复用。
• 错误路径：FullName 出错就停止或记录失败，不能静默替换为短名数组内容。

Go 官方也明确提醒，debug/pe 只做基础校验，并不以对抗恶意对象文件为目标。这个 API 适合自有、受信任的构建产物或隔离后的分析任务；如果输入来自上传或网络，先做资源限制和进程隔离，再考虑如何展示符号名。

常见问题

为什么 Name 明明有 8 个字节，打印却不是完整名称？

因为长名称不存放在 Name 中，Name 的后四字节只是字符串表偏移。应调用 FullName，而不是直接转换数组。

可以自己用偏移切 StringTable 吗？

可以，但必须复现格式判断、边界检查和零结尾规则。业务代码优先使用 StringTable.String，避免偏移错误被吞掉。

长名偏移为 0 代表字符串表开头吗？

在 Go 的 debug/pe 判断中，前四字节全零且偏移为 0 会被视为没有名称，不应强行读取成有效符号。

记住一句话即可：COFFSymbol.Name 是编码容器，不是稳定字符串字段；读取真实名称时使用 FullName(StringTable)，并把返回错误当成格式问题处理。