javafx 中所有尺寸（如 scene 宽高、hbox 间距、节点宽高等）默认单位为逻辑像素，实际渲染时会根据系统 dpi 缩放因子自动转换为设备像素，确保在高分屏上清晰显示。
javafx 中所有尺寸（如 scene 宽高、hbox 间距、节点宽高等）默认单位为逻辑像素，实际渲染时会根据系统 dpi 缩放因子自动转换为设备像素，确保在高分屏上清晰显示。
在 JavaFX 开发中，初学者常对数值单位产生疑惑——例如 Scene(root, 250, 50) 中的 250 和 50，或 HBox(15, btn1, btn2) 中的 15，究竟代表什么？答案是：它们均以逻辑像素（logical pixels）为单位，而非物理像素、英寸或 CSS 像素。
逻辑像素是 JavaFX 坐标系统的抽象单位，用于屏蔽底层显示设备的差异。JavaFX 渲染引擎会将逻辑像素乘以当前窗口或屏幕的缩放因子（outputScaleX / outputScaleY），再映射到实际的设备像素（device pixels）。这一机制使 UI 在 100%、125%、150% 或 200% 缩放的 Windows/macOS 系统，以及 macOS Retina 屏、Windows 高 DPI 显示器上均能保持视觉一致性和清晰度。
例如，在您的代码中：
Scene scene = new Scene(root, 250, 50); // 250×50 逻辑像素的场景区域 HBox root = new HBox(15, btn1, btn2); // 按钮间水平间距为 15 逻辑像素
- 250 和 50 定义了 Scene 内容区域的宽度与高度（不含窗口边框）；
- 15 表示 btn1 与 btn2 在 HBox 中的水平间距（spacing 属性）；
- 所有值均为 double 类型（尽管常写作整数），支持亚像素精度（如 3.75），以实现平滑动画与抗锯齿渲染。
值得注意的是，JavaFX 的坐标系原点 (0, 0) 位于舞台左上角，且整数坐标对应像素边界（cracks between pixels），而非像素中心。文档明确指出：
立即学习“Java免费学习笔记（深入）”；
“坐标 (0.5, 0.5) 指向左上角像素的中心；矩形 (0, 0, 10, 10) 覆盖从左上角像素左上顶点到第 10 行第 10 列像素右下顶点的区域。”
这意味着：精确控制像素对齐（如避免模糊）时，应优先使用 .5 偏移（如 setTranslateX(0.5)）。
可通过以下方式获取当前缩放因子，用于高级适配：
// 获取主窗口的水平/垂直缩放比例 double scaleX = primaryStage.getOutputScaleX(); double scaleY = primaryStage.getOutputScaleY(); // 或获取主屏幕的全局缩放设置 Screen screen = Screen.getPrimary(); double screenScaleX = screen.getOutputScaleX();
⚠️ 重要注意事项：
- 缩放因子由操作系统和 JVM 启动参数共同决定（如 -Dprism.allowhidpi=true 在旧版 JDK 中可能需显式启用）；
- 自定义绘图（如 Canvas 或 GraphicsContext）同样遵循该缩放规则，无需手动换算；
- 若需强制禁用缩放（仅限调试），可设置系统属性 -Dprism.allowhidpi=false，但不推荐用于生产环境；
- 使用 Region.setPrefSize()、Node.setLayoutX() 等 API 时，传入值始终为逻辑像素，JavaFX 自动处理后续映射。
综上，JavaFX 的“像素”是面向开发者的友好抽象层：它既保留了像素级控制的直观性，又通过自动缩放保障了跨设备一致性。理解逻辑像素与输出缩放的关系，是构建高 DPI 友好 JavaFX 应用的关键基础。
