物理常量页最容易被误认为“把几个数字排成列表”。但常量一旦同时用于学习展示、单位换算和模拟计算就必须回答三个问题数值来自哪里采用哪个定义或观测口径显示精度与计算精度是否一致。光速是定义值地球半径可能是平均半径或赤道半径月地距离也会随轨道变化如果模型只保存一段字符串这些差异会被界面悄悄抹平。“天体运行模拟”的ConstantsPage.ets已经实现了一个简洁的离线天文常数页用AstroConstant描述名称、符号、值和单位内置光速、万有引力常量、天文单位、太阳质量、地球质量、地球半径、月地距离和光年八条数据再通过 ArkUIList渲染统一卡片。本文基于这份真实源码复核八条内容的结构和展示边界并设计一套把“显示文本、计算数值、来源、口径和精度”分层的模型。当前页面没有来源字段、更新时间、数值类型或复制功能文章中的增强方案会明确标注为建议不会伪造成已有能力。唯一复核标记CONSTANT-ONE13-SOURCE-PRECISION-20260726常量数值、显示格式、来源口径和有效数字必须分开建模。验证基线与源码清单本文面向 HarmonyOS 5.0 及以上版本。实际工程应用版本为1.0.0targetSdkVersion为6.0.2(22)compatibleSdkVersion为6.0.1(21)入口模块支持phone、tablet、2in1。源码中的八条数据为名称符号显示值单位光速c3.0 x 10^8m/s万有引力常量G6.674 x 10^-11N·m²/kg²天文单位AU1.496 x 10^8km太阳质量M_sun1.989 x 10^30kg地球质量M_earth5.972 x 10^24kg地球半径R_earth6371km月地距离D_moon3.844 x 10^5km光年ly9.461 x 10^12km静态复核结果8 条记录全部拥有名称、符号、值和单位8 个value都是字符串来源字段为 0口径字段为 0有效数字字段为 0数值计算入口为 0。当前能力准确定位为“静态速查展示”。一、现有AstroConstant适合展示模型只有四个字符串字段interface AstroConstant { name: string symbol: string value: string unit: string }它的优点很直接不需要处理浮点格式化。科学计数形式可以原样显示。不同单位可以放在同一列表。ArkUI 绑定简单。这也是为什么当前页面稳定List只负责展示模型没有计算职责。缺点同样明显3.0 x 10^8不能安全用于乘除运算value中可能出现任意文本编译器无法检查单位与数值是否匹配。二、显示字符串不能充当计算常量如果直接解析parseFloat(3.0 x 10^8)结果只会得到3因为parseFloat在空格和x处停止。这说明显示文本与计算值必须分开。推荐interface PhysicalConstant { id: string name: string symbol: string siValue: number siUnit: string displayValue: string displayUnit: string }光速可以保存{ id: speed_of_light, name: 光速, symbol: c, siValue: 299_792_458, siUnit: m/s, displayValue: 2.99792458 × 10⁸, displayUnit: m/s }计算读取siValue页面读取displayValue两者不会互相解析。三、常量、参考值和平均值要区分页面标题叫“天文常数”但八条数据并不全是同一种语义。光速是定义值。天文单位是定义长度。万有引力常量是测量得到的物理常量。太阳质量与地球质量是天体参数的近似值。地球半径需要说明采用平均、赤道还是极半径。月地距离会变化384400 km通常是平均尺度。光年是由光速和时间定义推导出的长度。模型可以增加type ConstantKind | defined | measured | derived | reference | average用户就能知道“为什么有些数字可以写很多位有些只能近似”。四、来源不是一个可选装饰字段推荐每条数据记录interface ConstantSource { organization: string document: string edition: string publishedAt?: string url?: string }来源字段服务于审核与复核。常量更新。解释不同资料的数值差异。离线页面中的引用说明。防止开发者凭记忆修改常量。来源链接可以显示在详情页但应用仍可离线保存必要的组织、文档和版本文本。不要让“没有网络”成为“没有来源”的理由。五、有效数字需要显式建模源码显示c 3.0 x 10^8 m/s这只有 2 位有效数字。它适合入门速查但如果同一个值用于计算会损失大量精度。推荐增加interface PrecisionPolicy { significantDigits: number approximate: boolean uncertainty?: string }显示层按significantDigits格式化计算层继续使用完整siValue。近似值应显示≈定义值可以显示。六、科学计数符号要统一源码使用 ASCII 字符串3.0 x 10^8 6.674 x 10^-11在中文科学展示中更规范的视觉形式通常是3.0 × 10⁸ 6.674 × 10⁻¹¹Unicode 上标可用于短文本但不应手工维护所有指数。格式化函数可以生成const SUPERSCRIPT: Recordstring, string { -: ⁻, 0: ⁰, 1: ¹, 2: ², 3: ³, 4: ⁴, 5: ⁵, 6: ⁶, 7: ⁷, 8: ⁸, 9: ⁹ }如果目标字体缺少上标回退到e记法6.674e-11七、光速条目如何分离展示与定义当前显示值是3.0 x 10^8 m/s作为入门近似没有问题。更完整模型可以同时保存{ siValue: 299_792_458, displayDigits: 9, exact: true }页面提供两种展示简明3.00 × 10⁸ m/s精确299 792 458 m/s同一数值只维护一次避免卡片和换算器使用不同常量。八、万有引力常量需要保留测量语义源码显示G 6.674 x 10^-11 N·m²/kg²G的量级正确但它不是像光速那样的定义值。专业模型应允许保存不确定度或来源版本{ kind: measured, approximate: true, uncertainty: source-defined }文章不应仅靠多写几位小数制造“更准确”的错觉。没有来源和不确定度说明时合理做法是明确显示近似号。九、天文单位要避免米和千米重复维护源码以千米显示AU 1.496 x 10^8 km计算层建议只保存 SI 米值显示时转换function metersToKilometers( meters: number ): number { return meters / 1000 }如果同时手工维护米值和千米值一个值更新后另一个可能忘记同步。单一真源加单位换算更可靠。十、太阳质量与地球质量是近似参考量源码M_sun 1.989 x 10^30 kg M_earth 5.972 x 10^24 kg它们适合教学量级。若模拟引擎使用归一化质量M不要把页面中的kg直接传入模拟。应建立显式映射interface SimulationScale { massUnitInKg: number lengthUnitInMeters: number timeUnitInSeconds: number }公式页展示现实尺度模拟页使用教学单位两者可以关联但不能混为同一数据域。十一、地球半径必须写明口径源码显示R_earth 6371 km这个值常被用作平均半径。地球并非完全球体赤道半径和极半径不同。模型可以增加interface MeasurementContext { qualifier?: string epoch?: string referenceFrame?: string }对应条目context: { qualifier: mean radius }页面中文可显示“地球平均半径”比只写“地球半径”更准确。十二、月地距离不是固定轨道半径源码显示D_moon 3.844 x 10^5 km月球绕地球运行的距离会变化。速查页可以保留平均尺度但应把名称改为“月地平均距离”或在说明中标记近似。如果未来加入近地点、远地点和实时轨道数据它们应是不同条目不应覆盖当前参考值。十三、光年是长度单位源码把光年显示为ly 9.461 x 10^12 km光年名称包含“年”但它表示距离。详情中应说明光在真空中一个儒略年传播的距离单位换算页如果加入ly必须放在长度组。常量页与换算页应该共享同一个PhysicalConstants模块避免两处写不同值。十四、建立单一常量目录当前八条数据写在页面状态中State constants: AstroConstant[] [...]它们其实是静态目录不需要State。可以移到模型文件export const ASTRO_CONSTANTS: readonly PhysicalConstant[] [ // ... ]页面只读取目录private constants: readonly PhysicalConstant[] ASTRO_CONSTANTS单位换算、公式页和模拟说明也从同一模块导入减少重复。十五、页面状态与静态数据要分开State适合会触发 UI 更新的可变数据。八条常量在当前页面不会变化把它们标为State会暗示页面可能修改目录。真正需要状态的可能是搜索词。当前分类。展开的详情 ID。显示精度模式。复制成功提示。常量目录则应保持只读。这样用户交互不会意外改写基础数据。十六、格式化器应该是纯函数推荐interface FormatOptions { significantDigits: number scientificThreshold: number } function formatConstant( value: number, options: FormatOptions ): string { const abs Math.abs(value) if (abs 0) return 0 if (abs options.scientificThreshold || abs 1 / options.scientificThreshold) { return value.toExponential( options.significantDigits - 1 ) } return value.toPrecision( options.significantDigits ) }纯函数可以用测试向量验证不依赖 ArkUI 生命周期。十七、精度模式可以服务不同读者页面可以提供分段控制入门3 到 4 位有效数字。标准来源推荐精度。详细完整存储值和来源说明。切换模式只改变格式化不改变siValue。用户从简明切到详细后不会触发重新加载也不会产生两份常量。当前源码没有精度切换本文只是说明可扩展方向。十八、List卡片结构已经适合扩展每个列表项分为左侧 70vp 符号块。右侧名称。数值与单位行。符号使用主色数值使用橙色单位使用提示色。视觉层级清晰List({ space: 8 })也便于增加更多条目。符号块设置.maxLines(1) .textOverflow({ overflow: TextOverflow.Ellipsis })这能防止长符号撑破布局但M_earth在大字体下可能被截断。更好的显示是 Unicode 下标或缩短视觉符号并通过无障碍文本朗读完整名称。十九、长单位与大字体需要约束N·m²/kg²比kg长。当前值和单位放在同一Row在窄屏或大字体下可能拥挤。可以给数值使用layoutWeight(1)。单位允许换行或移动到下一行。设置maxLines和明确溢出策略。平板上保持卡片最大宽度。让详情页展示完整来源和单位。不要为了塞进一行而把单位字体缩到不可读。二十、多设备布局与安全区根容器使用.width(100%) .height(100%) .padding({ top: this.statusBarHeight, bottom: this.bottomBarHeight })手机单列列表合理。平板可以采用两列但应保持阅读顺序稳定2in1 可以增加键盘搜索和复制操作。不同设备共享同一常量目录、来源和精度规则布局层不能修改数值语义。需要验证状态栏、底部导航、横屏小窗口、系统字体放大以及长来源文本的滚动。二十一、复制功能应复制机器可用值用户点击复制时可以提供G 6.674 × 10⁻¹¹ N·m²/kg²也可以提供 ASCIIG 6.674e-11 N*m^2/kg^2前者适合文档后者适合代码和计算器。不要只复制卡片上截断后的字符串。当前源码没有复制功能新增时需要明确格式并提供成功反馈。二十二、常量目录的启动校验function validateConstants( items: readonly PhysicalConstant[] ): string[] { const errors: string[] [] const ids new Setstring() items.forEach((item: PhysicalConstant) { if (ids.has(item.id)) { errors.push(duplicate id: ${item.id}) } ids.add(item.id) if (!Number.isFinite(item.siValue)) { errors.push(invalid value: ${item.id}) } if (item.siUnit.length 0) { errors.push(empty unit: ${item.id}) } if (!item.source) { errors.push(missing source: ${item.id}) } }) return errors }开发构建可以执行完整校验正式构建至少保留安全回退避免单条错误阻塞整个页面。二十三、测试矩阵测试预期初始进入展示 8 条真实记录每条记录名称、符号、值、单位均非空返回按钮调用router.back()窄屏符号块与数值不重叠大字体长单位可读不遮挡下一项来源增强后每条都有来源版本精度切换只改变显示不改变siValue单位换算AU 与光年读取同一常量目录非有限数值校验失败不进入页面目录重复 ID启动校验报告错误现有源码可以复核前四项的结构基础来源、精度切换和共享目录属于建议实现。二十四、发布前检查常量 ID 唯一且稳定。计算数值与显示字符串分离。SI 值只维护一份。来源组织、文档和版本可复核。定义值、测量值、推导值和平均值有区分。有效数字与近似号一致。地球半径明确口径。月地距离标注平均或参考性质。光年归入长度。页面与单位换算共享常量目录。长单位、大字体和多设备不溢出。复制内容可选择科学显示或 ASCII。二十五、总结当前ConstantsPage.ets用统一模型和 ArkUI List 完成了八条天文数据的离线展示结构清楚、页面轻量适合作为学习工具的第一版。它的边界也很明确所有值都是显示字符串没有来源、口径、有效数字和计算类型。真正可靠的常量管理要把五件事分开数值、单位、显示格式、来源和测量语义。计算层使用单一 SI 真源展示层按读者需要控制有效数字来源层说明定义或观测口径。这样公式页、换算器和模拟说明才能共享同一份可验证数据而不是各自维护一串看起来相近的数字。说明本文基于真实 HarmonyOS/ArkTS 源码进行整理部分文字与示例由 AI 辅助生成所有现有能力与建议改造已明确区分。