接口参考

known_issues.md · 已知限制 · 3/5

按同一接口文件归组浏览,展开条目查看声明、使用说明和版本边界。

阅读相关开发指南 →

这里保留接口声明及来源。逐项运行验证范围以条目记录为准;源文件中的内部实现候选不代表免费 SDK 的交付承诺。

docs/known_issues.md
T-DEBT-FLAT-IFC-FALLBACK-STRUT-NATURAL-HEIGHT
已知问题3.61.7C++

扁平 IFC 回退路径的根 strut 在 line-height:normal 时仍取字体自然高,与文字条目的 normal 行高不一致

验证范围

docs/known_issues.md:176

反馈此接口问题 →
T-DEBT-FLEX-AUTO-MIN-WHOLE-PIXEL-CEIL
已知问题3.61.7C++

flex item 的自动最小值(min-width:auto)按整像素上取整

验证范围

docs/known_issues.md:304

反馈此接口问题 →
T-DEBT-FLEX-COLUMN-REPLACED-CROSS-STRETCH-RATIO
已知问题3.61.7C++

列向 flex 在交叉轴 stretch 后没有按自然比例重新传递替换图片高度

验证范围

docs/known_issues.md:62

反馈此接口问题 →
T-DEBT-FLEX-ITEM-GRID-BRANCH-CEIL-AFTER-GRID-FRACTIONAL-TRACKS
已知问题3.61.7C++

Grid 已按小数 auto 轨道定宽后,Flex 的 Grid 分支仍保护性上取整根宽

验证范围

docs/known_issues.md:61

反馈此接口问题 →
T-DEBT-FLEX-ITEM-GRID-FR-FIT-CONTENT-STILL-BY-TRIAL
已知问题3.61.7C++

flex item 本身是 / 包着列里有 fit-content() 的 grid(或显式列 + fr 隐式列)时,flex base 仍按无限宽试排的几何量

验证范围

docs/known_issues.md:60

反馈此接口问题 →
T-DEBT-FONT-FALLBACK-COVERAGE-AND-GENERIC-SANS
已知问题3.61.7C++

webfont 缺字后的逐 glyph coverage 与 Windows generic sans fallback 顺序

验证范围

docs/known_issues.md:262

反馈此接口问题 →
T-DEBT-FRAME-RADIUS-NONWINDOWS
已知问题3.61.7C++

为 Linux/macOS 顶层窗口补齐 frameRadius 原生轮廓裁剪、命中、阴影与 DPI 行为

验证范围

docs/known_issues.md:388

反馈此接口问题 →
T-DEBT-FULL-SUITE-LOAD-FLAKY-TESTS
已知问题3.61.7C++

全量普通测试在同机有别的构建并发时会出现个别 EXE 瞬时失败,而且失败现场没被保存、无法诊断

验证范围

docs/known_issues.md:293

反馈此接口问题 →
T-DEBT-GENERATED-FIRST-LETTER-PSEUDO-DECORATION
已知问题3.61.7C++

生成内容的 ::first-letter 拿不到 ::before 自己声明的装饰线

验证范围

docs/known_issues.md:367

反馈此接口问题 →
T-DEBT-GENERIC-FALLBACK-CHROME-PARITY
已知问题3.61.7C++

通用族的回退字形与 Chrome 仍有三处不同

验证范围

docs/known_issues.md:265

反馈此接口问题 →
T-DEBT-GEOMETRIC-LIST-MARKER-INLINE-ADVANCE-PARITY
已知问题3.61.7C++

默认几何列表标记的1.36em前进量估算与Chrome used marker box不一致

验证范围

docs/known_issues.md:217

反馈此接口问题 →
T-DEBT-GORUST-CANONICAL-MANIFEST-UNGATED
已知问题3.61.7C++

Go/Rust canonical examples 镜像与 manifest 没有任何门禁校验

验证范围

docs/known_issues.md:288

反馈此接口问题 →
T-DEBT-GRID-ANONYMOUS-PRESERVED-EDGE-SHAPING-PARITY
已知问题3.61.7C++

Grid 保留空格可折点与行首字形整形边界的推进差

验证范围

docs/known_issues.md:308

反馈此接口问题 →
T-DEBT-GRID-FIXED-REPEAT-COMPUTED-SERIALIZATION
已知问题3.61.7C++

固定 repeat 在计算样式中展开,轨道计算值序列化无法保留重复记法

验证范围

docs/known_issues.md:75

反馈此接口问题 →
T-DEBT-GRID-FIXED-ROW-PERCENT-INTRINSIC-BOUNDARIES
已知问题3.61.7C++

固定行的百分比/宽高比水平查询仍缺 stretch 包装、固定 minmax 与最大使用宽基准

验证范围

docs/known_issues.md:79

反馈此接口问题 →
T-DEBT-GRID-OWN-PERCENT-BOX-MODEL-KNOWN-ADJACENT-GEOMETRY
已知问题3.61.7C++

C8 护栏中与自身百分比基准无关的相邻几何精确快照

验证范围

docs/known_issues.md:306

反馈此接口问题 →
T-DEBT-GRID-PARTIAL-FR-AUTO-STRETCH-KNOWN-ADJACENT-GEOMETRY
已知问题3.61.7C++

A176 护栏相邻几何的临时精确快照需要逐根因解除

验证范围

docs/known_issues.md:307

反馈此接口问题 →
T-DEBT-GRID-PRESERVED-TAB-INTRINSIC-ADVANCE-PARITY
已知问题3.61.7C++

Grid 保留 Tab 的固有宽与字符列近似终排尚未达到真实字体 Tab stop

验证范围

docs/known_issues.md:82

反馈此接口问题 →
T-DEBT-GRID-TEMPLATE-CSSOM-USED-TRACK-SIZES
已知问题3.61.7C++

有 Grid 盒时模板轨道的 getComputedStyle 仍返回计算值,未适配已使用轨道长度

验证范围

docs/known_issues.md:74

反馈此接口问题 →
T-DEBT-HIT-TEST-BROWSER-SUBPIXEL-CONTRACT
已知问题3.61.7C++

KUI精确点与浏览器亚像素边缘命中区域不同

验证范围

docs/known_issues.md:114

反馈此接口问题 →
T-DEBT-ICU-DATA-MACOS-LINUX-VALIDATION
已知问题3.61.7C++

在 macOS/Linux 构建并验证精简 ICU Data,建立各平台 unit/WPT/像素基线后再启用过滤

验证范围

docs/known_issues.md:387

反馈此接口问题 →
T-DEBT-IDLE-WAKE-NONWINDOWS-NEVER-REARMS
已知问题3.61.7C++

Linux / macOS 的空闲唤醒定时器排上后永不改间隔

验证范围

docs/known_issues.md:394

反馈此接口问题 →
T-DEBT-IFC-BASELINE-SOLVER
已知问题3.61.7C++

IFC baseline 求解器收口

验证范围

docs/known_issues.md:148

反馈此接口问题 →
T-DEBT-IFC-BOUNDARY-MIDWORD-RESIDUAL-SHAPES
已知问题3.61.7C++

含断行边界的段落里,几种形状的长词仍被从中间断开(保持修复前的行为)

验证范围

docs/known_issues.md:180

反馈此接口问题 →
T-DEBT-IFC-EXPORTED-BASELINE-BELOW-STRUT
已知问题3.61.7C++

IFC 导出的首 / 末行基线可低于根 strut 基线(主字体 + 回退字体、带作者行高的行)

验证范围

docs/known_issues.md:165

反馈此接口问题 →
T-DEBT-IMG-EMPTY-SOURCE-BROWSERCOMPAT-FALLBACK-BAND
已知问题3.61.7C++

BrowserCompat 将无 src 图片也套用加载失败图片的 20px 回退高度

验证范围

docs/known_issues.md:142

反馈此接口问题 →
T-DEBT-INLINE-ATOMIC-JUSTIFY-FIXTURE-RESOURCE-SETTLEMENT
已知问题3.61.7C++

调查inline atomic justify全套像素失败与资源终态

验证范围

docs/known_issues.md:244

反馈此接口问题 →
T-DEBT-INLINE-BOX-DECORATION-BREAK-CLONE
已知问题3.61.7C++

box-decoration-break:clone 对跨行行内元素只在绘制侧生效,排版不给每个片段两端加 padding / 边框

验证范围

docs/known_issues.md:332

反馈此接口问题 →
T-DEBT-INLINE-EFFECT-OWNER-OVERFLOW-RESET-INTERACTION
已知问题3.61.7C++

「只裹一个浮动的 opacity 行内」(effect owner)在 layoutBlockChildren 里写下的浮动范围,同一趟随后被 visitInlineCBs 的「非包含块行内清溢出」清回 0

验证范围

docs/known_issues.md:320

反馈此接口问题 →
T-DEBT-INLINE-LIST-ANON-IFC-MARKER-INTEGRATION
已知问题3.61.7C++

普通 inline list-item 的匿名父 IFC、IB-split 首尾边缘与 marker 所有权统一

验证范围

docs/known_issues.md:214

反馈此接口问题 →
T-DEBT-INLINE-LISTITEM-FRAGMENT-MARKER
已知问题3.61.7C++

普通 display:inline list-item 的角色、marker 与 block-in-inline split 几何

验证范围

docs/known_issues.md:213

反馈此接口问题 →
T-DEBT-INLINE-ROOT-RUN-COLLECTOR-PARITY
已知问题3.61.7C++

InlineLayout 独立行内根的 run 收集器与整段路径不一致:<br> 被吞(嵌套相对定位一项已随 B24 合入消失)

验证范围

docs/known_issues.md:157

反馈此接口问题 →
T-DEBT-INLINE-RTL-LIST-ITEM-GEOMETRY
已知问题3.61.7C++

补齐 inline list-item 与 RTL inside marker 的行内几何

验证范围

docs/known_issues.md:210

反馈此接口问题 →
T-DEBT-INSIDE-MARKER-TEXT-UNBREAKABLE
已知问题3.61.7C++

inside 文字标记比行宽长时不折行、两端对齐时不被拉伸

验证范围

docs/known_issues.md:343

反馈此接口问题 →
T-DEBT-INSIDE-TEXT-MARKER-DECORATION
已知问题3.61.7C++

inside 文字列表标记不画 li 传播下来的装饰线

验证范围

docs/known_issues.md:342

反馈此接口问题 →
T-DEBT-INTRINSIC-ARABIC-WORD-CEIL-PLUS-ONE
已知问题3.61.7C++

阿拉伯文连写词的 max-content 被 IntrinsicSizer 上取整再加 1px,盒比 Chrome 宽约 1~2px

验证范围

docs/known_issues.md:104

反馈此接口问题 →
T-DEBT-INTRINSIC-SIZER-CROSS-NODE-SHAPING
已知问题3.61.7C++

IntrinsicSizer 的行内 max-content 逐文字节点整形后求和,看不到跨节点的整形交互

验证范围

docs/known_issues.md:112

反馈此接口问题 →
T-DEBT-INTRINSIC-SIZER-KEYWORD-CONTRIBUTION-PARITY
已知问题3.61.7C++

IntrinsicSizer 覆盖不到旧关键字求值器处理过的多种形状,块级关键字宽度无法整体切过去;行向 flex item 的关键字宽度(A59)已经在用它

验证范围

docs/known_issues.md:106

反馈此接口问题 →
T-DEBT-INTRINSIC-STANDALONE-PRESERVED-TEXT-EDGES-GRID-ONLY
已知问题3.61.7C++

独立保留空白文本行的边缘测量目前只在 Grid 祖先下统一

验证范围

docs/known_issues.md:102

反馈此接口问题 →
T-DEBT-INTRINSIC-TRAILING-LETTER-SPACING
已知问题3.61.7C++

固有宽度少算最后一个字符后的字距

验证范围

docs/known_issues.md:317

反馈此接口问题 →
T-DEBT-LAYOUT-DEPTH-GUARD-THRESHOLD-STALE
已知问题3.61.7C++

校准布局深度保护阈值

验证范围

docs/known_issues.md:321

反馈此接口问题 →
T-DEBT-LEGACY-CLAMP-NEXT-LINE-IN-PADDING
已知问题3.61.7C++

Chrome 的旧式 -webkit-line-clamp 只截高度,下一行的上沿露在下 padding 里;KUI 不画被截掉的行

验证范围

docs/known_issues.md:341

反馈此接口问题 →
T-DEBT-LETTER-SPACING-PINNED-KNOWN-DEVIATIONS
已知问题3.61.7C++

test_letter_spacing_per_line_start_offset 把三类与 Chrome 的已知差精确钉在 dev / 跳过项里

验证范围

docs/known_issues.md:160

反馈此接口问题 →
T-DEBT-LINE-CLAMP-CROSSING-INLINE-DISCARDED-FRAGMENTS
已知问题3.61.7C++

跨过 line-clamp 截断点的行内元素(前半在保留行、后半被截掉),getClientRects() 缺被截掉那几行的片段

验证范围

docs/known_issues.md:206

反馈此接口问题 →
T-DEBT-LINE-CLAMP-LEGACY-SCROLL-EXTENT-CSSOM-ONLY
已知问题3.61.7C++

旧语法 line-clamp 宿主只有 CSSOM scrollHeight 含被截掉的行,滚动范围 / scrollWidth / DevTools 滚动信息不含

验证范围

docs/known_issues.md:207

反馈此接口问题 →
T-DEBT-LINE-CLAMP-MODERN-NATIVE-ELLIPSIS-SOFT-LINE-CUT
已知问题3.61.7C++

现代 line-clamp 走 SkParagraph 原生省略号的形状(>3 行、非起始对齐等,F-WPT-FIX-950 的软换行回退路径只覆盖 2~3 行起始对齐 LTR),最后一行仍有悬挂空白偏移 / 多留下一个词的头几个字

验证范围

docs/known_issues.md:204

反馈此接口问题 →
T-DEBT-LINE-CLAMP-OVERFLOW-VISIBLE-DISCARDED-PAINT
已知问题3.61.7C++

旧语法 line-clamp 在 overflow:visible 时,部分容器外文字的绘制与 Chrome 不同

验证范围

docs/known_issues.md:201

反馈此接口问题 →
T-DEBT-LINE-HEIGHT-NORMAL-CAP-TWICE-FONT-SIZE
已知问题3.61.7C++

line-height:normal 的 2×字号上限与 Chrome 不同(只影响内容带远高于字号的异常字体,如 Javanese Text)

验证范围

docs/known_issues.md:335

反馈此接口问题 →
T-DEBT-LINUX-CANVAS-TEXT-MEASURE-ZERO
已知问题3.61.7C++

Linux Canvas 文本测量为零

验证范围

docs/known_issues.md:326

反馈此接口问题 →
T-DEBT-LINUX-POPUP-DISMISS-ON-WINDOW-DEACTIVATE-UNVERIFIED
已知问题3.61.7C++

Linux 上主窗口失焦(Alt+Tab、点别的程序)时 select 下拉 / 右键菜单是否关闭未验证

验证范围

docs/known_issues.md:380

反馈此接口问题 →
T-DEBT-LINUX-POPUP-NO-COMPOSITOR
已知问题3.61.7C++

Linux 无 compositor 弹窗行为

验证范围

docs/known_issues.md:379

反馈此接口问题 →
T-DEBT-LINUX-TEXT-RASTER-PROFILE
已知问题3.61.7C++

Linux 字体光栅配置与浏览器/桌面环境对齐

验证范围

docs/known_issues.md:324

反馈此接口问题 →
T-DEBT-LINUX-TRAYICON-NOT-IMPLEMENTED
已知问题3.61.7C++

Linux TrayIcon 实现

验证范围

docs/known_issues.md:381

反馈此接口问题 →
T-DEBT-LIST-MARKER-DEVICE-SPACE-RASTER
已知问题3.61.7C++

对齐 fractional transform/zoom 下的曲线 marker 设备像素吸附与抗锯齿

验证范围

docs/known_issues.md:247

反馈此接口问题 →
T-DEBT-LONG-TEST-EXE-NEAR-RUNNER-TIMEOUT
已知问题3.61.7C++

个别测试 EXE 单跑时长逼近 run_tests.py 的单 EXE 超时 300 s,负载下会超时

验证范围

docs/known_issues.md:294

反馈此接口问题 →
T-DEBT-MACOS-MENU-SHORTCUT-NOT-BOUND
已知问题3.61.7C++

macOS 菜单快捷键绑定

验证范围

docs/known_issues.md:385

反馈此接口问题 →
T-DEBT-MACOS-TEXT-RASTER-PROFILE
已知问题3.61.7C++

macOS 字体光栅配置与 Chromium/CoreText 行为对齐

验证范围

docs/known_issues.md:325

反馈此接口问题 →
T-DEBT-MACOS-TRAY-BALLOON-DEPRECATED-API
已知问题3.61.7C++

替换 macOS 托盘气泡废弃 API

验证范围

docs/known_issues.md:384

反馈此接口问题 →
T-DEBT-MRG-DEVTOOLS-OUTERHTML-CONTRACT
已知问题3.61.7C++

DOM.setOuterHTML名称与实际innerHTML操作不一致

验证范围

docs/known_issues.md:296

反馈此接口问题 →
T-DEBT-MRG-DEVTOOLS-REMAINING-PARAM-SCHEMA
已知问题3.61.7C++

DevTools剩余域未统一typed参数契约

验证范围

docs/known_issues.md:295

反馈此接口问题 →
T-DEBT-MRG-FORM-DOCUMENT-INVALIDATION-COST
已知问题3.61.7C++

有限表单约束的文档范围样式失效成本未定量

验证范围

docs/known_issues.md:353

反馈此接口问题 →
T-DEBT-MRG-FORM-PATTERN-COST
已知问题3.61.7C++

显式form pattern校验缺可证明复杂度边界

验证范围

docs/known_issues.md:228

反馈此接口问题 →
T-DEBT-MRG48-CROSS-ENGINE-BASELINE-METRICS
已知问题3.61.7C++

表格bottom对齐与Chrome存在未归因小数残差

验证范围

docs/known_issues.md:316

反馈此接口问题 →
T-DEBT-MULTICOL-PROJECTED-DAMAGE-CULL
已知问题3.61.7C++

恢复多栏分片重放中的投影后 damage 裁剪与缓存

验证范围

docs/known_issues.md:246

反馈此接口问题 →
T-DEBT-MULTILINE-INLINE-OUTLINE-RADIUS
已知问题3.61.7C++

跨行行内元素的 outline 合并轮廓不画圆角

验证范围

docs/known_issues.md:331

反馈此接口问题 →
T-DEBT-NEGATIVE-LAYER-INLINE-ROOT-OWNED-EXTRAS
已知问题3.61.7C++

负 z-index 行内元素在负层画字形之后的残留:几样仍由 IFC 根在根的层画

验证范围

docs/known_issues.md:252

反馈此接口问题 →
T-DEBT-NO-BACKEND-ANON-IFC-LINE-HEIGHT
已知问题3.61.7C++

无后端(没有 SkParagraph)时 legacy 匿名块 IFC 的行高口径与直接文字盒不同

验证范围

docs/known_issues.md:167

反馈此接口问题 →
T-DEBT-OVERFLOW-WRAP-DEFER-NON-SPACE-OPPORTUNITY
已知问题3.61.7C++

overflow-wrap 先换行再切词只认作者空格 / tab:本行最近的断行机会是 -、/、表意文字之间等位置时仍在当前行切,带浮动 / 表单控件的旧逐段排版路径也仍就地切

验证范围

docs/known_issues.md:338

反馈此接口问题 →
T-DEBT-PARITY-3D-TRANSFORM
已知问题3.61.7C++

CSS 3D transform(rotateY / perspective / transform-style 等)无效

验证范围

docs/known_issues.md:249

反馈此接口问题 →
T-DEBT-PARITY-FIT-CONTENT-FUNCTION
已知问题3.61.7C++

fit-content(<length>) 函数形式的结果与 Chrome 不同(Chrome 400 / KUI 218)

验证范围

docs/known_issues.md:103

反馈此接口问题 →
T-DEBT-PARITY-FONT-METRICS-BASELINE-PHASE
已知问题3.61.7C++

行内基线亚像素相位与 Chrome 差一个像素行(240 个形状里 60 个)

验证范围

docs/known_issues.md:170

反馈此接口问题 →
T-DEBT-PARITY-GAP-PERCENT-INDEFINITE
已知问题3.61.7C++

inline size 不定的容器里 gap:<percentage> 解析为 0

验证范围

docs/known_issues.md:118

反馈此接口问题 →
T-DEBT-PARITY-GRID-MAXCONTENT-INLINE-SIBLINGS
已知问题3.61.7C++

grid width:max-content 对 cell 内的 inline 兄弟按 block 逐个取 max,而非整段 IFC 一次测量

验证范围

docs/known_issues.md:73

反馈此接口问题 →
T-DEBT-PARITY-REMOTE-FONT-MODEL
已知问题3.61.7C++

只有同步的本地字体加载模型:无远程 @font-face src:url() 下载;unicode-range 解析但不应用;font-display 无可观察差异

验证范围

docs/known_issues.md:263

反馈此接口问题 →
T-DEBT-PARITY-SCROLLWIDTH-ELLIPSIS
已知问题3.61.7C++

nowrap + text-overflow:ellipsis 盒的 scrollWidth 不反映未截断全宽

验证范围

docs/known_issues.md:187

反馈此接口问题 →
T-DEBT-PARITY-TAB-SIZE
已知问题3.61.7C++

tab-size 未实现(实测 width 72 vs Chrome 118)

验证范围

docs/known_issues.md:151

反馈此接口问题 →
T-DEBT-PARITY-TEXT-INDENT-NEGATIVE
已知问题3.61.7C++

负 text-indent 的悬挂缩进不生效

验证范围

docs/known_issues.md:150

反馈此接口问题 →
T-DEBT-PARITY-UAX14-HYPHEN-BREAK
已知问题3.61.7C++

疑似不按 UAX#14 在连字符后断行

验证范围

docs/known_issues.md:152

反馈此接口问题 →
T-DEBT-PDF-SPECIALIZED-FRAGMENTATION
已知问题3.61.7C++

补齐 paged multicol 与 Flex/Grid/Table 专用分页语义

验证范围

docs/known_issues.md:115

反馈此接口问题 →
T-DEBT-PERF-CORPUS-ASYNC-IMAGE-LAYOUT-HISTORY
已知问题3.61.7C++

性能等价语料的异步图片输入历史尚未受控

验证范围

docs/known_issues.md:243

反馈此接口问题 →
浏览同类接口 →