2026 年 PsychoPy 适合远程 Mac 做实验吗？

判断框｜适合：远程 Mac 可用于安装 PsychoPy、调试 Builder／Coder 项目和预检流程；如果你的研究依赖精确时序、被试响应或专用外设，远程桌面上的运行结果不能代替实际显示和采集设备验收。PsychoPy 官方举例说明，60 Hz 显示器的单帧约为 16.7 ms，但这个刷新周期本身并不能证明刺激已按预期出现在被试面前。PsychoPy 时序与同步说明

这篇文章适合需要在实验室缺少 Mac 时验证 PsychoPy 项目的心理学、认知科学研究生。
如果你负责高校实验室的实验系统，可据此划分软件调试与正式采集验收。
维护跨平台实验项目的研究者，也可以用这些指标判断远程 macOS 环境能补足哪一段测试。

PsychoPy 远程 Mac 实验：先区分三种“可用”

“PsychoPy 能启动”“实验流程能走通”和“正式采集通过验收”是三个不同结论。远程 Mac 通常能帮你检查 macOS 下的安装、代码、资源路径、界面和基本流程；但屏幕实际呈现、被试端响应以及设备同步，仍取决于运行实验的硬件组合。

因此，远程 macOS 实验环境更适合承担开发和预检任务。若你的研究不依赖精确刺激时序，且只需检查脚本逻辑或教学演示，远程运行可能已覆盖主要需求；若研究依赖刺激起始时间、按键反应时或 EEG 触发，则必须把实际采集设备和显示环境纳入验收。

判断时先问自己：你要确认的是程序有没有执行，还是被试实际接收到的刺激和设备信号是否符合研究设计？前者可以先在远程 Mac 上检查，后者不能只凭远程画面下结论。

屏幕与时序：软件日志不是刺激实测

PsychoPy 会记录帧间隔，也能协助你发现异常长的帧；这有助于定位代码绘制负担、后台任务或显示设置引起的问题。不过，日志记录的是软件可观察到的渲染过程，不等于直接测到了显示器发光的时刻。

官方建议：对时序敏感的实验，应检查实际刺激呈现，并使用光电二极管等物理设备测量刺激出现时间；如果还要评估触发信号与刺激之间的关系，光电二极管能帮助检查两者之间的延迟及其波动。PsychoPy 时序与同步说明

检查掉帧可以先从 PsychoPy 的帧间隔记录开始。以下代码按官方文档的接口开启记录；运行中应安排不改变画面的静止阶段，避免把等待期间的帧间隔误当作刺激绘制异常。掉帧检测文档

from psychopy import visual

win = visual.Window(fullscr=True)
win.recordFrameIntervals = True

# 在此运行代表性刺激流程
# 测试结束后检查帧间隔记录
print("记录的帧间隔数量：", len(win.frameIntervals))

输出示例（仅说明输出形式，不代表实测结果）：

记录的帧间隔数量：若干

这份记录适合回答“运行时是否出现帧间隔异常”，不能单独回答“刺激何时真正到达被试的视网膜”。PsychoPy 官方还指出，固定刷新率屏幕只能按帧呈现：例如 100 Hz 屏幕的一个刷新周期是 10 ms，短刺激时长需按可实现的帧数设计，而不能只填写任意毫秒数。刺激时长与屏幕刷新说明

⚠️ 远程桌面画面看起来顺畅，只能说明你当前收到的远程画面观感平稳；它既没有测量运行端显示器的发光时刻，也没有验证被试端的响应或同步信号。

显示条件：预检屏幕与被试屏幕分开记录

远程操作时，你看到的画面显示在本地设备上；实验程序则运行在远端 Mac 上。由此需要分开记录两件事：远端运行环境中的软件行为，以及被试实际观看的显示器条件。本地屏幕上的流畅度、窗口大小或色彩观感，不能直接当作被试实验屏幕的验收结果。

如果任务依赖特定刷新表现、全屏显示、刺激尺寸或观看距离，就要在计划用于采集的显示器上核对对应条件。PsychoPy 的单位设置也会受屏幕像素尺寸、物理尺寸和观看距离影响；使用视角单位时，屏幕信息与被试距离需要和实际布置相匹配。刺激单位与观看距离说明

对于不需要校准显示器的代码调试或教学演示，远程 Mac 可以帮助你检查窗口是否创建、刺激是否载入、流程是否按逻辑切换。若你的研究需要被试看到特定尺寸、颜色或亮度，则应在正式使用的显示器上测量和校准，而不是沿用远程桌面预览的视觉印象。

响应与外设：先核对连接链路

键盘、反应盒、眼动仪、EEG 或生理采集设备，不应仅按“PsychoPy 有对应组件”来判断兼容。官方文档说明，PsychoPy 可通过不同接口与外部硬件通信；具体操作涉及设备所用的并行端口、串口、网络连接、驱动及设备端配置，必须按你实验室的实际型号逐项核实。外部硬件通信文档

键盘输入也要按实验设计判断。PsychoPy 的硬件键盘 API 提供异步轮询和按键时间戳等能力，但远程桌面输入是经由远程访问链路传递的按键，不能未经测试就当作被试现场的反应设备。普通键盘预检可用来确认事件处理逻辑；需要测量被试反应时或依赖专用反应盒时，应在正式使用的输入设备上验收。硬件键盘 API 文档

如果实验通过串口向 EEG 或其他采集设备发送触发信号，必须确认触发确实被采集端收到，并检查它与屏幕刺激之间的关系。PsychoPy 的串口触发文档建议先用基础实验检查信号是否到达，并可使用光电二极管核对视觉刺激与触发时序。串口触发与测试说明

实际核对时，可按下面的顺序操作：

1. 列出验收目标。写明你要验证的是程序启动、流程逻辑、帧间隔、反应输入、触发信号，还是以上多个项目。
2. 记录运行与观看设备。分别记下 PsychoPy 实际运行在哪台 Mac、被试观看哪台显示器，以及远程连接只用于操作还是也参与实验流程。
3. 检查显示参数。核对刷新率、全屏模式、屏幕物理尺寸、像素尺寸和观看距离；涉及视角单位时，确认配置对应正式采集屏幕。
4. 运行代表性流程。在远程环境中检查 Builder／Coder 项目能否打开、资源能否读取、关键条件分支能否执行，并启用帧间隔记录，查看是否有掉帧迹象。
5. 检查响应与外设。逐个确认键盘、反应盒、眼动仪或 EEG 的接口和数据路径；对触发链路，使用设备端记录确认信号是否抵达，而不是只检查 PsychoPy 端代码是否运行。
6. 做实际硬件测量。只要研究结论依赖刺激实际呈现时间或同步精度，就在正式显示器和采集设备上进行测量，并记录设备组合、设置和结果。
7. 保存验收边界。把软件检查结果、硬件测量结果和未验证项目分开记录；若远程环境无法接入某个外设，就将其标记为“未验证”，不要写成“已兼容”。

数据与权限：远程调试不等于批准处理被试数据

远程 Mac 可用于检查代码、实验资源和模拟流程，但能否处理真实被试数据，要服从你所在机构的数据管理、访问控制和伦理审批要求。你应核实文件存放位置、谁能访问、数据是否需要去标识化，以及实验室是否允许经由远程环境传送或处理这些数据。

尤其要区分“能技术连接”和“获准处理”。即使你能打开项目或访问文件，也不表示数据管理或伦理审查已经批准该工作方式。若机构不允许被试信息离开指定存储环境，就只在远程环境运行不含真实个人数据的测试项目，并向实验室负责人确认合规流程。

FAQ：远程 Mac 上的 PsychoPy 验收边界

PsychoPy 项目在远程 Mac 上可以完成哪些运行检查？

可以用于安装软件、运行项目和检查流程，但项目启动或完整走完流程，只能说明软件执行路径得到初步验证。正式采集是否可用，还要看被试观看的显示器、响应设备、外设连接及同步信号。把软件预检和硬件验收分开记录，能避免将“能运行”误写成“实验已验证”。

远程桌面预览能否作为刺激时序的验收依据？

远程桌面画面是否流畅，不是刺激时序的测量结果。PsychoPy 的日志可检查帧间隔，物理测量设备则可检查刺激实际出现的时间；若实验需要精确刺激时序，应在正式显示器上进行硬件测量，并核对触发与刺激之间的关系。没有这些实测时，不宜仅凭远程预览判断时序可靠。

如何排查 PsychoPy 任务中的掉帧和刺激延迟？

先在 PsychoPy 中开启帧间隔记录，使用代表性任务运行，并查看异常帧间隔或掉帧警告；再结合显示器刷新率，确认目标刺激时长能否按帧实现。若你还需要知道屏幕何时实际亮起，帧间隔日志不够，需要用光电二极管等方式测量。记录每项检查实际回答的问题，避免混用软件日志和硬件结果。

EEG 或眼动设备接入远程 Mac 前要确认什么？

取决于设备接口、驱动、控制端和远程连接方式。需要逐项确认设备是否要求直连运行实验的 Mac、信号经由什么链路传输，以及触发能否被采集端记录。PsychoPy 支持多种外部硬件通信方式，但这不代表你的特定设备和远程环境已经通过验证；没有真实设备测试，就应保留“待验收”状态。

按任务选择：远程预检、实验室实测或本地运行

下表用于确定远程 Mac 的角色，不用于替代你的实验设计或实验室设备验收。尤其要注意：不依赖精密时序的项目可以把远程环境用于较多开发工作；依赖实际刺激和外设同步的项目，则应把硬件验收放在计划采集的设备组合上完成。

从刷新周期看，固定刷新率也会限制刺激能持续的时间：60 Hz 对应约 16.7 ms 每帧，100 Hz 对应 10 ms 每帧；因此，不能把任意指定的毫秒时长都视为显示器可以准确呈现。PsychoPy 的官方说明建议对短刺激按帧数设定，并结合实际显示条件检查。固定刷新率与刺激时长说明 Builder 刺激起止时间说明

如果实验室目前只有 Linux 或 Windows 设备，它们可以继续承担既有开发和分析工作，但不能代替 macOS 项目验证；购置本地 Mac 则涉及一次性设备投入和后续管理。远程 Mac 适合补足短期软件调试与 macOS 验证，不过远程访问链路、外设接入和被试端显示仍是需要单独确认的环节，因此它不是所有正式采集项目的长期替代方案。

如果你只是缺一套 macOS 环境来预检 PsychoPy 项目，可以先查看 OakVM 的远程 Mac 方案比较，再核实你的实验是否需要直连外设、现场显示器或专用同步设备；这些条件未确认前，不要把远程测试当作正式验收。若设备接入边界不明确，可先通过联系 OakVM确认远程环境适用条件，再决定它是否适合你的调试流程。

常见问题