diff --git a/.sdkmanrc b/.sdkmanrc
new file mode 100644
index 0000000..77c3c31
--- /dev/null
+++ b/.sdkmanrc
@@ -0,0 +1,13 @@
+# 本模块（团委后端）固定工具链版本，由 sdkman 管理。
+#
+# 为什么要固定：
+#  - 项目是 Spring Boot 2.5.4 + <java.version>1.8</java.version>，lombok 由父 POM 管到
+#    1.18.20，不支持 JDK 17，用默认 JDK 17 编译必然失败。
+#  - 本机 sdkman 全局默认是 java 17.0.20-tem（TmsERP 等其它项目在用），
+#    所以只能按项目固定，不能改 sdk default。
+#
+# 用法：进入本目录即自动切换（~/.sdkman/etc/config 里 sdkman_auto_env=true）。
+# 非交互式 shell（脚本/CI）需显式执行：
+#   source ~/.sdkman/bin/sdkman-init.sh && sdk env
+java=8.0.504+1-tem
+maven=3.9.16