## 任务目标
请为当前 Vue 3 系统制定 TDesign Vue Next 接入方案,或复核已有接入。
以核查和评审为主,给出有证据的判断及可复核的修改建议;本次用户另有明确实现要求时,按其授权范围执行。
## 输入信息(选填)
两项均可留空,也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表;能读取的内容由执行者补齐。
组件库接入目标:
工程或页面资料:
## 信息不完整时
先使用本次对话中已经说明的信息;用户留空、写“暂无/不清楚”或未替换输入标记,都按缺失处理,不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问,不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料,不为补齐输入擅自扩大操作范围。
### 优先确认
- 确认桌面 Vue 3 适用范围、现有组件库、常用控件及重复能力。
- 核对注册方式、解析器、函数式调用和全局样式加载,确认现有按需方案是否完整。
- 读取构建和目标浏览器配置,检查生产资源、外部脚本版本及样式重置的布局影响。
### 可采用的默认处理
- 默认复核已有接入,不因提示词出现 TDesign 就迁移 Vue 2、小程序或其他组件库。
- 优先保留能正常工作的全量或按需方式,无产物收益证据时不加自动导入插件。
- 采用锁文件中的兼容版本和既有业务页面验证,缺体积基线只记录当前产物,不填提升比例。
### 必须有依据的事项
- 当前技术栈与桌面 Vue 3 TDesign 不兼容,而达成目标需要未经明确要求的框架或组件库迁移。
- 新库必须支持的目标浏览器或关键控件行为与现有约束冲突,无法据工程确定取舍。
只有缺口会改变业务结果、权限边界或关键实现,且无法从现有资料确认时,才集中提出最多 3 个关键问题;说明影响,并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定,不逐项等待确认。
### 资料仍不足时的交付
- 没有工程时交付最小接入示例、注册和样式检查点,注明仅适用桌面 Vue 3。
- 没有构建或浏览器环境时给涉及文件与验证命令,首次弹窗、直达刷新及产物兼容标为待测。
## 执行要求
接入范围限定为桌面端 Vue 3 与 TDesign Vue Next。项目使用 Vue 2、其他组件库或小程序时,先指出不适用部分,不直接替换工程依赖。
1. 确认真实入口、路由、样式加载顺序、组件使用比例和目标浏览器。列出已有组件库及重复能力,判断采用 TDesign 是新增统一组件还是局部接入,避免同一业务控件在不同页面出现多套行为。
2. 按实际使用范围选择全量注册、显式按需引入或自动导入。说明选择依据与维护成本,不把按需引入当成无条件要求;只有产物分析能证明收益时,才为体积目标增加相关插件。
3. 核对包版本、解析器和构建插件,使用项目锁文件固定可复现依赖。检查生产构建是否依赖未固定版本的外部脚本或样式;需要外部资源时列明来源、版本和不可用时的业务影响。
4. 确认基础全局样式已加载,检查自动导入是否同时处理组件和函数式调用。对输入框、选择器、表格、弹窗各做一个真实页面引用,识别缺样式、重复样式、组件未注册及编辑器提示失效等问题。
5. 复核样式重置与现有布局的关系,特别检查盒模型、弹层、滚动区域和中文标签。使用有业务含义的页面内容,不增加装饰性标语、虚构统计数据或大面积炫光;布局保持对齐、层级清楚、操作集中。
6. 通过项目既有构建命令生成产物,检查包体、资源请求和相关浏览器中的真实页面。分别记录首屏正常、路由切换、按需弹窗首次打开及刷新后直达页面的结果,失败时保留具体报错和复现路径。
## 交付与验收
输出:接入方式及理由、涉及文件与配置、依赖版本、产物对比、页面验收结果。性能结论必须包含实测条件;缺少基线只给采集方法。无法运行时,标记所有待验证项并提供最小接入代码,不虚报浏览器兼容或上线完成。
### 本条完成检查
- 明确接入方式、理由、版本、文件和样式入口,检查组件及函数式调用均可用。
- 用真实页面覆盖输入框、选择器、表格和首次弹窗,排除未注册、缺样式和重复样式。
- 执行生产构建并记录资源与浏览器页面检查,首屏、切路由和刷新直达分别报告。
按本条要求组织结果,使用简洁中文和一致的编号、术语、缩进及空行;已有项目格式优先。只说明实际完成的内容,将采用的假设、未完成项和缺少的条件写在相关位置,不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注,不宣称已通过或已有性能收益。
## 参考资料与适用边界
官方来源(2026-09-08 核验):
- [腾讯 TDesign《TDesign Vue Next 安装与使用》](https://github.com/Tencent/tdesign-vue-next/blob/develop/packages/tdesign-vue-next/site/docs/getting-started.md)