From 4ad4bb2073890b7f7edb5d5f5af44b6ba998aeea Mon Sep 17 00:00:00 2001
From: arktomson <2372929539@qq.com>
Date: Sat, 14 Feb 2026 00:01:29 +0800
Subject: [PATCH] =?UTF-8?q?fix(useSetState):=20=E6=94=AF=E6=8C=81=E9=BB=98?=
 =?UTF-8?q?=E8=AE=A4=20initialState=20=E4=B8=BA=E7=A9=BA=E5=AF=B9=E8=B1=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 允许 useSetState 无参调用，默认初始值为 {}

- 新增空初始状态用例测试并更新中英文文档

- 参照 react-use 的 API 设计

Fixes #2729
---
 .../src/useSetState/__tests__/index.spec.ts   | 20 ++++++++++++++++++-
 packages/hooks/src/useSetState/index.en-US.md |  4 ++--
 packages/hooks/src/useSetState/index.ts       |  2 +-
 packages/hooks/src/useSetState/index.zh-CN.md |  4 ++--
 4 files changed, 24 insertions(+), 6 deletions(-)

diff --git a/packages/hooks/src/useSetState/__tests__/index.spec.ts b/packages/hooks/src/useSetState/__tests__/index.spec.ts
index dd58721335..4a236063a9 100644
--- a/packages/hooks/src/useSetState/__tests__/index.spec.ts
+++ b/packages/hooks/src/useSetState/__tests__/index.spec.ts
@@ -3,7 +3,7 @@ import { describe, expect, test } from 'vitest';
 import useSetState from '../index';
 
 describe('useSetState', () => {
-  const setUp = <T extends object>(initialValue: T) =>
+  const setUp = <T extends object>(initialValue?: T) =>
     renderHook(() => {
       const [state, setState] = useSetState<T>(initialValue);
       return {
@@ -38,4 +38,22 @@ describe('useSetState', () => {
     });
     expect(hook.result.current.state).toEqual({ count: 1 });
   });
+
+  test('should support empty initial state', () => {
+    const hook = renderHook(() => {
+      const [state, setState] = useSetState<{ hello?: string }>();
+      return {
+        state,
+        setState,
+      } as const;
+    });
+
+    expect(hook.result.current.state).toEqual({});
+
+    act(() => {
+      hook.result.current.setState({ hello: 'world' });
+    });
+
+    expect(hook.result.current.state).toEqual({ hello: 'world' });
+  });
 });
diff --git a/packages/hooks/src/useSetState/index.en-US.md b/packages/hooks/src/useSetState/index.en-US.md
index 6bfbf2d2f7..3cb9b686fd 100644
--- a/packages/hooks/src/useSetState/index.en-US.md
+++ b/packages/hooks/src/useSetState/index.en-US.md
@@ -20,7 +20,7 @@ useSetState works similar to `this.setState` of class component, used to manage
 ## API
 
 ```typescript
-const [state, setState] = useSetState<T>(initialState);
+const [state, setState] = useSetState<T>(initialState?);
 ```
 
 ### Result
@@ -34,4 +34,4 @@ const [state, setState] = useSetState<T>(initialState);
 
 | Property     | Description   | Type           | Default |
 | ------------ | ------------- | -------------- | ------- |
-| initialState | Initial state | `T \| () => T` | -       |
+| initialState | Initial state | `T \| () => T` | `{}`    |
diff --git a/packages/hooks/src/useSetState/index.ts b/packages/hooks/src/useSetState/index.ts
index ca8b0db2ba..8fbbdc4201 100644
--- a/packages/hooks/src/useSetState/index.ts
+++ b/packages/hooks/src/useSetState/index.ts
@@ -7,7 +7,7 @@ export type SetState<S extends Record<string, any>> = <K extends keyof S>(
 ) => void;
 
 const useSetState = <S extends Record<string, any>>(
-  initialState: S | (() => S),
+  initialState: S | (() => S) = {} as S,
 ): [S, SetState<S>] => {
   const [state, setState] = useState<S>(initialState);
 
diff --git a/packages/hooks/src/useSetState/index.zh-CN.md b/packages/hooks/src/useSetState/index.zh-CN.md
index c06c148b0f..f714fd1aff 100644
--- a/packages/hooks/src/useSetState/index.zh-CN.md
+++ b/packages/hooks/src/useSetState/index.zh-CN.md
@@ -20,7 +20,7 @@ nav:
 ## API
 
 ```typescript
-const [state, setState] = useSetState<T>(initialState);
+const [state, setState] = useSetState<T>(initialState?);
 ```
 
 ### Result
@@ -34,4 +34,4 @@ const [state, setState] = useSetState<T>(initialState);
 
 | 参数         | 说明     | 类型           | 默认值 |
 | ------------ | -------- | -------------- | ------ |
-| initialState | 初始状态 | `T \| () => T` | -      |
+| initialState | 初始状态 | `T \| () => T` | `{}`   |