Files
reflux/rfx_alias_test.go
T
what 5c9f8bd6e7 perf: 用类型布局缓存 + 指针偏移寻址重写热路径
将实验目录 experiment/fastx 的实现合入主实现,替换原来逐次反射的做法。

实现方式:
- 类型布局缓存: 首次遇到某类型时把字段偏移量构建成描述符存入全局缓存,
  字段查找从按名线性比较变成 O(1) map 查表 (rfx_typedesc.go)
- 指针偏移寻址: 取字段时用 基址+偏移量 直接算地址, 不再构造中间 reflect.Value
  (unsafeptr.go, 全部 unsafe 代码集中在这一个文件)
- 零分配路径解析: 路径按需切片遍历, 不再为每次 Get 分配临时切片 (path.go)
- 标量直读: String/Int/Bool/Float64 在类型匹配时直接按机器类型读内存,
  绕开 interface 装箱和 cast 转换

语义复杂、调用频次低的操作(复合类型赋值、Append、Delete、容器转换)仍走原
reflect 实现, 保留为冷路径 refx (rfx_reflect.go), 避免重写引入行为偏差。

新增包级泛型函数 Get[T](r, path...), 按路径直接取出目标类型, 零内存分配。
语义与 r.Get(path...).Xxx() 严格等价, 不改动任何现有接口。

性能对比(同进程同数据, -benchmem -count=6 中位数):
- Get 嵌套 + String   150.6ns/7allocs -> 50.7ns/2allocs   2.97x
- Get 4 层深路径      234.1ns/10allocs -> 68.9ns/2allocs  3.40x
- Set 单层            65.8ns/2allocs  -> 18.1ns/0allocs   3.64x
- Set 嵌套           122.1ns/3allocs  -> 35.5ns/0allocs   3.44x
- Exists             127.4ns/5allocs  -> 37.2ns/1alloc    3.42x
- 访问器 String        15.0ns/1alloc   -> 1.3ns/0allocs   11.8x
- Get[string] 泛型直取                 -> 29.9ns/0allocs   5.04x
两处不快: map 键访问 1.25x(map 无稳定布局, 仍走 reflect);
New 构造 0.67x(多一次描述符缓存查找, 一次性成本)。

内存安全: 未导出字段在读和写两处显式拦截 —— reflect.NewAt 构造的 Value
不带只读标记, 语言层面的导出规则保护在 unsafe 路径上失效, 必须自己拦。
不变式与评审要点见 unsafeptr.go 顶部注释。

测试: 新增 703 个用例全部通过, 含 go test -race。
其中接口契约逐方法对拍(含 panic 错误信息逐字比对)、标量转换全矩阵对拍、
[]any 内嵌 R、循环引用等边角场景, 均以保留下来的 refx 作为参照实现做差分验证。
合并过程中据此发现并修复 11 处行为偏差。
2026-08-28 16:37:04 +08:00

93 lines
3.1 KiB
Go

package reflux
// 链式 Get 传的是地址而不是数据副本 —— 这一点决定了每次 Get 那 1 次分配
// 只是 24 字节的游标, 与被访问数据的大小无关。
import "testing"
// 链式 Get 到底是"传地址"还是"每一跳复制一份数据"?
//
// 结论: 传地址。每次 Get 在堆上新建的只是一个 24 字节的游标(类型描述符指针 +
// 目标地址 + 可写标记), 它的 ptr 字段直接指向原对象内部, 被访问的数据一个字节
// 都没有被复制。
func TestChainedGetSharesAddress(t *testing.T) {
o := newUxOuter()
r := New(o)
// 原始字段的真实地址
want := &o.Mid.Inner.City
oneShot := r.Get("Mid", "Inner", "City").Ptr().(*string)
dotted := r.Get("Mid.Inner.City").Ptr().(*string)
chained := r.Get("Mid").Get("Inner").Get("City").Ptr().(*string)
if oneShot != want {
t.Fatalf("一次调用拿到的不是原字段地址: %p vs %p", oneShot, want)
}
if dotted != want {
t.Fatalf("点号路径拿到的不是原字段地址: %p vs %p", dotted, want)
}
if chained != want {
t.Fatalf("链式调用拿到的不是原字段地址: %p vs %p", chained, want)
}
// 中间跳也是原对象内部的地址, 不是副本
mid := r.Get("Mid").Ptr().(*uxMiddle)
if mid != &o.Mid {
t.Fatalf("中间跳 Mid 不是原地址: %p vs %p", mid, &o.Mid)
}
uxInner := r.Get("Mid").Get("Inner").Ptr().(*uxInner)
if uxInner != &o.Mid.Inner {
t.Fatalf("中间跳 Inner 不是原地址: %p vs %p", uxInner, &o.Mid.Inner)
}
// 经链式写入, 必须落到原对象上
r.Get("Mid").Get("Inner").Set("City", "WrittenViaChain")
if o.Mid.Inner.City != "WrittenViaChain" {
t.Fatalf("链式写入没落到原对象: %q", o.Mid.Inner.City)
}
}
// reflux 现有实现同样是地址传递(reflect.Value 内部存的也是字段地址),
// 两边在这一点上语义一致。
func TestRefluxAlsoSharesAddress(t *testing.T) {
o := newUxOuter()
r := newLegacy(o)
want := &o.Mid.Inner.City
got := r.Get("Mid").Get("Inner").Get("City").Ptr().(*string)
if got != want {
t.Fatalf("reflux 链式拿到的不是原字段地址: %p vs %p", got, want)
}
}
// 唯一会复制的两种情况: map 取值 和 interface 拆出非指针值。
// 它们在 Go 里本来就不可寻址, reflect 也一样只能给副本。
func TestMapAndIfaceAreCopies(t *testing.T) {
o := newUxOuter()
r := New(o)
// map: 两次取同一个键, 拿到两个不同的地址 => 是副本
a := r.Get("Objs", "o1").Ptr().(*uxInner)
b := r.Get("Objs", "o1").Ptr().(*uxInner)
if a == b {
t.Fatal("map 取值应该每次给一份独立副本")
}
if a.City != "Chengdu" || b.City != "Chengdu" {
t.Fatalf("副本内容不对: %q %q", a.City, b.City)
}
// interface 里装的是非指针值, 同样是副本
c := r.Get("Mid", "Any").Ptr().(*uxInner)
d := r.Get("Mid", "Any").Ptr().(*uxInner)
if c == d {
t.Fatal("interface 拆非指针值应该每次给一份独立副本")
}
// 但 slice 元素是原地址(底层数组), 不是副本
e := r.Get("Structs", "0").Ptr().(*uxInner)
if e != &o.Structs[0] {
t.Fatalf("slice 元素应该是原地址: %p vs %p", e, &o.Structs[0])
}
}