From 690bb4089efaeebf490f1cdb28c6325a5d731366 Mon Sep 17 00:00:00 2001
From: unanmed <1319491857@qq.com>
Date: Thu, 24 Sep 2026 19:53:37 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=80=A7=E8=83=BD?=
 =?UTF-8?q?=E5=8F=82=E8=80=83=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 dev.md  |  2 ++
 perf.md | 13 +++++++++++++
 2 files changed, 15 insertions(+)
 create mode 100644 perf.md

diff --git a/dev.md b/dev.md
index ff48877..4c5f32b 100644
--- a/dev.md
+++ b/dev.md
@@ -120,6 +120,8 @@
 - 对象的非空判断用 `!obj`，字面量的非空判断用 `!isNil(value)`。
 - 任何情况下都不建议写 `try-catch-finally`，哪怕有时会因为报错导致某些关键状态产生错误，产生错误就应该让用户去修，而不是让系统兜底。
 
+- 参考 `perf.md` 来了解一些细节上面的性能指南。
+
 ## 双端分离
 
 样板将渲染端与数据端彻底分离：
diff --git a/perf.md b/perf.md
new file mode 100644
index 0000000..3f6a302
--- /dev/null
+++ b/perf.md
@@ -0,0 +1,13 @@
+# `Map.getOrInsert` vs `Map.getOrInsertComputed`
+
+- 使用 `Map.getOrInsert`: 数字、短字符串（约 100 以内）、布尔值、空数组、空对象、对象引用
+- 使用 `Map.getOrInsertComputed`: 长字符串、空 Set、空 Map、自定义类构建出的实例（new Class()）、有内容的数组、有内容的对象、有内容的 Set、有内容的 Map。
+- 使用哪个都可以: 函数
+
+注：如果是直接传引用，那么用 `Map.getOrInsert`，以上对比的是现场构建条件下的性能表现，而非直接传入引用，对比直接传入引用没有任何意义。
+
+Benchmark:
+
+- [Benchmark1](https://www.measurethat.net/Benchmarks/Show/35964/1/getorinsert-vs-getorinsertcomputed-1)
+- [Benchmark2](https://www.measurethat.net/Benchmarks/Show/35965/1/getorinsert-vs-getorinsertcomputed-2)
+- [Benchmark3](https://www.measurethat.net/Benchmarks/Show/35966/1/getorinsert-vs-getorinsertcomputed-3)