From b8908cf3ef4798a6ed6b2d37aa3691bb18c80f33 Mon Sep 17 00:00:00 2001
From: Looly <loolly@aliyun.com>
Date: Wed, 26 Nov 2025 20:02:12 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=BC=BA`HexUtil`=E8=87=AA=E5=8A=A8?=
 =?UTF-8?q?=E5=8E=BB=E9=99=A4`0x`=E5=92=8C`#`=E5=89=8D=E7=BC=80=EF=BC=88pr?=
 =?UTF-8?q?#4163@Github=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md                                  |  1 +
 .../java/cn/hutool/core/util/HexUtil.java     | 44 +++++++++++--------
 2 files changed, 26 insertions(+), 19 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 149cbe4d5..436920000 100755
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -12,6 +12,7 @@
 * 【core   】      优化`EscapeUtil`，兼容不规范的转义（pr#4150@Github）
 * 【core   】      优化`ObjectUtil.contains`String改为CharSequence（pr#4154@Github）
 * 【poi    】      `Word07Writer`增加addText重载，支持字体颜色（pr#1388@Gitee）
+* 【core   】      增强`HexUtil`自动去除`0x`和`#`前缀（pr#4163@Github）
 
 ### 🐞Bug修复
 * 【jwt    】      修复verify方法在定义alg为`none`时验证失效问题（issue#4105@Github）
diff --git a/hutool-core/src/main/java/cn/hutool/core/util/HexUtil.java b/hutool-core/src/main/java/cn/hutool/core/util/HexUtil.java
index ac2f55e03..0f209c483 100755
--- a/hutool-core/src/main/java/cn/hutool/core/util/HexUtil.java
+++ b/hutool-core/src/main/java/cn/hutool/core/util/HexUtil.java
@@ -27,7 +27,7 @@ public class HexUtil {
 	 * @return 是否为16进制
 	 */
 	public static boolean isHexNumber(String value) {
-		if(StrUtil.startWith(value, '-')){
+		if (StrUtil.startWith(value, '-')) {
 			// issue#2875
 			return false;
 		}
@@ -35,7 +35,7 @@ public class HexUtil {
 		if (value.startsWith("0x", index) || value.startsWith("0X", index)) {
 			index += 2;
 		} else if (value.startsWith("#", index)) {
-			index ++;
+			index++;
 		}
 		try {
 			new BigInteger(value.substring(index), 16);
@@ -296,20 +296,6 @@ public class HexUtil {
 		return Integer.toHexString(value);
 	}
 
-	/**
-	 * 去除十六进制字符串的常见前缀 0x、0X、#
-	 *
-	 * @param s 十六进制字符串
-	 * @return 去除前缀后的字符串
-	 */
-	private static String stripHexPrefix(String s) {
-		if (s == null) return null;
-		s = s.trim();
-		if (s.startsWith("0x") || s.startsWith("0X")) return s.substring(2);
-		if (s.startsWith("#")) return s.substring(1);
-		return s;
-	}
-
 	/**
 	 * 16进制字符串转为int
 	 *
@@ -318,7 +304,7 @@ public class HexUtil {
 	 * @since 5.7.4
 	 */
 	public static int hexToInt(String value) {
-		return Integer.parseInt(stripHexPrefix(value), 16);
+		return Integer.parseInt(removeHexPrefix(value), 16);
 	}
 
 	/**
@@ -340,7 +326,7 @@ public class HexUtil {
 	 * @since 5.7.4
 	 */
 	public static long hexToLong(String value) {
-		return Long.parseLong(stripHexPrefix(value), 16);
+		return Long.parseLong(removeHexPrefix(value), 16);
 	}
 
 	/**
@@ -366,7 +352,7 @@ public class HexUtil {
 		if (null == hexStr) {
 			return null;
 		}
-		return new BigInteger(stripHexPrefix(hexStr), 16);
+		return new BigInteger(removeHexPrefix(hexStr), 16);
 	}
 
 	/**
@@ -406,4 +392,24 @@ public class HexUtil {
 		return builder.toString();
 	}
 
+	/**
+	 * 去除十六进制字符串的常见前缀 0x、0X、#
+	 *
+	 * @param hexStr 十六进制字符串
+	 * @return 去除前缀后的字符串
+	 */
+	private static String removeHexPrefix(String hexStr) {
+		if (StrUtil.length(hexStr) > 1) {
+			final char c0 = hexStr.charAt(0);
+			switch (c0) {
+				case '0':
+					if (hexStr.charAt(1) == 'x' || hexStr.charAt(1) == 'X') {
+						return hexStr.substring(2);
+					}
+				case '#':
+					return hexStr.substring(1);
+			}
+		}
+		return hexStr;
+	}
 }