Ant Design 6.5.2 是一次聚焦视觉一致性的修复版本。此次更新解决了多个组件的边框没有响应全局 lineWidth 与 lineType Design Token 的问题。对于维护企业级后台、设计系统或多品牌 React 应用的团队，这类修复虽然不像新组件那样醒目，却直接影响主题配置能否成为可靠的单一视觉来源。
修复解决了什么问题
Ant Design 允许应用通过 ConfigProvider 配置全局 Design Token。理论上，修改 lineWidth 或 lineType 后，依赖标准边框的组件应当同步变化；但在此前的实现中，部分组件没有完整消费这两个 Token，容易出现同一页面中边框宽度或样式不一致的情况。
6.5.2 涉及的组件包括：
ButtonCollapseColorPickerLayoutSelectSpace.AddonTreeTypography
这意味着，当项目统一调整边框宽度或类型时，上述组件现在能够更一致地响应全局主题。实际收益主要体现在高对比度主题、品牌定制、紧凑型后台界面，以及需要明确控件边界的无障碍设计中。
需要注意的是，这次更新针对的是边框 Token 的响应问题，并不意味着所有组件的每一条边框都会变得完全相同。组件自身的结构、状态样式和局部 Token 仍可能影响最终结果，例如按钮的危险状态、选择器的聚焦状态或折叠面板的分隔线。
在 React 项目中验证全局边框
可以先将依赖升级到 6.5.2，并在一个最小页面中集中展示受影响组件。下面以 Vite React 项目为例；已有项目只需执行安装命令并改造入口组件。
npm create vite@latest antd-border-check -- --template react
cd antd-border-check
npm install
npm install antd@6.5.2
npm run dev
将 src/App.jsx 替换为以下内容。示例把全局边框设置为 2px dashed，目的是让 Token 是否生效一眼可见；生产环境通常应使用更克制的值。
import React from 'react';
import {
Button,
Collapse,
ColorPicker,
ConfigProvider,
Layout,
Select,
Space,
Tree,
Typography,
} from 'antd';
const { Header, Content } = Layout;
const { Title, Text } = Typography;
const treeData = [
{
title: 'Engineering',
key: 'engineering',
children: [{ title: 'Frontend', key: 'frontend' }],
},
];
export default function App() {
return (
<ConfigProvider
theme={{
token: {
lineWidth: 2,
lineType: 'dashed',
colorBorder: '#5b6472',
},
}}
>
<Layout style={{ minHeight: '100vh' }}>
<Header style={{ color: '#fff' }}>Border token check</Header>
<Content style={{ padding: 24 }}>
<Space direction="vertical" size="large" style={{ width: '100%' }}>
<Title level={3}>Ant Design 6.5.2</Title>
<Text>检查组件是否统一响应全局边框 Token。</Text>
<Space wrap>
<Button>Default button</Button>
<ColorPicker defaultValue="#1677ff" />
<Select
defaultValue="production"
style={{ width: 180 }}
options={[
{ value: 'production', label: 'Production' },
{ value: 'staging', label: 'Staging' },
]}
/>
</Space>
<Collapse
items={[
{
key: 'release',
label: 'Release details',
children: <p>Global border tokens should be visible here.</p>,
},
]}
/>
<Tree treeData={treeData} defaultExpandAll />
</Space>
</Content>
</Layout>
</ConfigProvider>
);
}
运行后，不要只检查默认静止状态。还应依次观察按钮悬停、选择器聚焦、折叠面板展开，以及树节点选中时的边框表现。Design Token 修复可能会让以前依赖默认样式的视觉回归测试产生截图差异，这通常是预期变化，但仍需人工确认。
升级时应检查局部覆盖
如果项目中存在大量 CSS 覆盖，全局 Token 生效后可能与旧规则叠加。可以先搜索直接写死的边框声明：
rg "border(-width|-style)?\s*:|--ant-line" src
重点检查以下几类代码：
- 使用
!important覆盖 Ant Design 样式的规则。 - 针对
.ant-btn、.ant-select-selector等内部类名的选择器。 - 同时配置全局 Token、组件 Token和业务 CSS 的页面。
- 将边框宽度写进截图基线或像素级断言的测试。
如果确实需要某个组件保持不同边框，优先使用组件级主题配置或业务组件封装，而不是继续扩大全局 CSS 选择器的作用范围。这样能保留全局主题的一致性，也能降低后续 Ant Design 升级时内部类名变化带来的风险。
采用建议
对于已经使用 Ant Design 6 的项目，6.5.2 属于值得尽快纳入常规补丁升级的版本，尤其是配置过 lineWidth、lineType 或自定义边框颜色的应用。升级前后建议完成三项检查：锁定并确认实际安装版本、运行受影响组件的视觉回归测试、清理与 Token 冲突的局部 CSS。
若项目从旧主版本直接迁移到 Ant Design 6，则不要把这次补丁修复当作完整迁移依据。主版本升级仍应单独检查废弃 API、主题结构、React 版本约束和构建配置。6.5.2 解决的是一组明确的边框一致性问题，而稳定升级仍取决于项目自身的组件封装与测试覆盖。