javafx 中所有尺寸（如 scene 宽高、hbox 间距、节点宽高等）默认单位为逻辑像素（logical pixels），在标准显示器上等同于物理像素；在高 dpi 屏幕上则会自动应用系统级缩放因子（如 1.25x、2x），确保 ui 清晰且尺寸感知一致。
javafx 中所有尺寸（如 scene 宽高、hbox 间距、节点宽高等）默认单位为逻辑像素（logical pixels），在标准显示器上等同于物理像素；在高 dpi 屏幕上则会自动应用系统级缩放因子（如 1.25x、2x），确保 ui 清晰且尺寸感知一致。
在 JavaFX 开发中，初学者常对数值单位产生疑惑——例如 Scene(250, 50) 中的 250 和 50，或 HBox(15, btn1, btn2) 中的 15，究竟代表什么？答案是：它们均以逻辑像素（logical pixels）为单位。
逻辑像素是 JavaFX 坐标系统的基准单位。它并非固定绑定到物理像素，而是由底层窗口系统动态映射。JavaFX 的渲染引擎在高分辨率（HiDPI）显示器（如 macOS Retina、Windows 缩放设置为 125% 或 150%）上会自动引入缩放因子（scale factor），将逻辑像素转换为实际绘制的设备像素，从而避免 UI 元素模糊或过小。
例如，在 HBox(15, btn1, btn2) 中，15 表示两个按钮之间的水平逻辑像素间距；在 Scene(root, 250, 50) 中，250 和 50 分别表示场景内容区域的逻辑宽度与高度。这些值始终按逻辑坐标系解释，与屏幕物理分辨率解耦。
值得注意的是，JavaFX 使用浮点坐标系统（double 类型），支持亚像素精度。根据官方文档，坐标 (0, 0) 对应画布左上角的像素边界（即“像素裂缝”），而 (0.5, 0.5) 恰好指向左上角像素的中心。因此，一个宽高均为 10 的矩形，从 (0, 0) 开始绘制时，其覆盖范围是从左上角像素边界延伸至第 10 行第 10 列像素的右下边界，最后一个内部像素中心位于 (9.5, 9.5)。
立即学习“Java免费学习笔记（深入）”；
为适配不同显示环境，开发者可通过以下 API 获取当前缩放系数：
// 获取主 Stage 的输出缩放因子（通常与所属 Screen 一致） double scaleX = primaryStage.getOutputScaleX(); double scaleY = primaryStage.getOutputScaleY(); // 或查询当前屏幕全局缩放信息 Screen screen = Screen.getPrimary(); double screenScaleX = screen.getOutputScaleX(); double screenScaleY = screen.getOutputScaleY();
✅ 关键注意事项：
- 不建议手动乘以缩放因子调整尺寸值——JavaFX 已在布局、渲染、事件坐标等全流程自动处理；
- 自定义绘图（如 Canvas）中若需精确控制设备像素，可结合 getOutputScaleX() 进行坐标转换；
- CSS 中的尺寸单位（如 -fx-padding: 10px）同样基于逻辑像素，px 在 JavaFX CSS 中即指逻辑像素，不等同于浏览器中的 CSS 像素；
- 若需强制禁用缩放（仅限调试），可通过 JVM 参数 -Dprism.allowhidpi=false 启动应用（不推荐用于生产环境）。
总之，理解“逻辑像素”这一概念，是掌握 JavaFX 跨平台、跨设备 UI 一致性的基础。开发者只需以逻辑像素为单位进行布局设计，JavaFX 将自动完成高 DPI 适配，真正实现“一次编写，清晰运行”。
