From fd79fd4de5761aa6958e14062771a057ce00d625 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=81=87=E8=A7=81=E5=90=8C=E5=AD=A6?= <1875694521@qq.com> Date: Fri, 28 Nov 2025 23:54:33 +0800 Subject: [PATCH] docs: add atomic migration instructions for v6 installation (#55958) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs: add atomic migration instructions for v6 installation * Update docs/react/migration-v6.zh-CN.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Signed-off-by: 遇见同学 <1875694521@qq.com> * Update docs/react/migration-v6.en-US.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Signed-off-by: 遇见同学 <1875694521@qq.com> --------- Signed-off-by: 遇见同学 <1875694521@qq.com> Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- docs/react/migration-v6.en-US.md | 4 ++++ docs/react/migration-v6.zh-CN.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/docs/react/migration-v6.en-US.md b/docs/react/migration-v6.en-US.md index d9c247efaa..152765328b 100644 --- a/docs/react/migration-v6.en-US.md +++ b/docs/react/migration-v6.en-US.md @@ -372,6 +372,10 @@ In v5, Form.List was treated as a single Field, causing `onFinish` to include al - CSS variables are enabled by default and only modern browsers are supported. - IE is no longer supported. Some older domestic browsers may have compatibility issues — please verify target browsers before shipping your app. +### Atomic Migration: Install v6 via Package Alias + +- If you need to limit the migration's impact, you can try an [atomic migration](https://github.com/ant-design/ant-design/discussions/55957). Please note that this is not the recommended upgrade path. + ## Upgrade checklist To ensure your app works correctly after upgrading to v6, please go through the following checklist: diff --git a/docs/react/migration-v6.zh-CN.md b/docs/react/migration-v6.zh-CN.md index 00bae77389..ca9c3c77fa 100644 --- a/docs/react/migration-v6.zh-CN.md +++ b/docs/react/migration-v6.zh-CN.md @@ -368,6 +368,10 @@ v5 版本中,Form.List 会被认为是一个 Field,以至于提交时会包 - 默认开启 **CSS variables**,仅支持现代浏览器。 - IE 浏览器不再支持,部分旧版国产浏览器可能存在兼容性问题,请在应用发布前确认目标浏览器的支持情况。 +### 原子级通过别名安装 v6 + +- 如果你需要控制升级的影响范围,可以尝试[原子级迁移](https://github.com/ant-design/ant-design/discussions/55957)方案。请注意,这并非我们推荐的升级路径。 + ## 升级影响排查 Checklist 为了确保升级到 v6 后项目正常运行,请参考以下检查清单逐项确认: