【免费下载】 PsychoPy入门指南：从零开始掌握心理学实验构建工具

一、PsychoPy概述

PsychoPy是一个开源的心理学实验构建工具，它提供了两种主要的工作模式：Builder（可视化构建器）和Coder（代码编辑器）。无论你是心理学研究者还是编程爱好者，PsychoPy都能帮助你快速创建专业的实验程序。

二、两种工作模式对比

1. Builder模式（可视化界面）

Builder模式是PsychoPy的图形化界面，适合没有编程基础的用户：

• 通过拖拽组件构建实验流程
• 直观的时间线编辑功能
• 自动生成实验代码
• 特别适合在线实验研究

优势：

• 无需编程经验
• 快速原型设计
• 内置常用实验组件
• 自动处理实验数据记录

2. Coder模式（代码编辑）

Coder模式为有编程经验的用户提供：

• 完整的Python代码编辑环境
• 语法高亮和代码折叠
• 丰富的示例代码库
• 直接访问PsychoPy API

优势：

• 完全控制实验逻辑
• 实现复杂实验设计
• 集成第三方Python库
• 更高效的代码执行

三、快速入门教程

Builder模式入门：Hello World实验

1. 启动PsychoPy并选择Builder视图
2. 从组件面板拖拽"Text"组件到实验流程中
3. 在文本属性对话框中输入"Hello world!"
4. 设置显示时间为3.2秒
5. 点击运行按钮(Ctrl-R/Cmd-R)

常见问题排查：

• 确保从新建文档开始(Ctrl-N/Cmd-N)
• 检查文本组件是否正确放置
• 验证时间参数是否为数值

进阶Builder技巧

• 使用"Loop"组件创建重复试验
• 添加"Response"组件收集被试反应
• 利用"Code"组件插入自定义Python代码
• 通过"Experiment Settings"配置全局参数

四、从Builder到Coder

PsychoPy允许将Builder实验编译为Python代码：

1. 在Builder视图中按F5或点击编译按钮
2. 系统自动切换到Coder视图显示生成代码
3. 可在此代码基础上进行进一步修改

重要提示：

• 从Builder到Coder是单向转换
• 建议尽可能在Builder中完成修改
• 使用Ctrl-L/Cmd-L快速切换视图

五、Coder模式深入

基础示例：西班牙语问候

from psychopy import visual, core

win = visual.Window()
msg = visual.TextStim(win, text=u"\u00A1Hola mundo!")

msg.draw()
win.flip()
core.wait(1)
win.close()

Coder Shell交互式环境

Coder内置Python Shell，支持逐行执行代码：

>>> from psychopy import visual, core
>>> win = visual.Window()
>>> msg = visual.TextStim(win, text=u"\u00A1Hola mundo!")
>>> msg.draw()
>>> win.flip()

Shell优势：

• 实时测试代码片段
• 快速调试实验逻辑
• 交互式探索PsychoPy功能

六、跨平台使用指南

• Windows：通过开始菜单快捷方式启动
• macOS：直接运行应用程序包
• Linux：通过命令行启动或创建桌面快捷方式

启动参数：

• --coder或-c：直接进入Coder视图
• --builder或-b：直接进入Builder视图

七、学习路径建议

1. 初学者：从Builder模式开始，熟悉基本实验结构
2. 中级用户：尝试编译Builder实验并阅读生成代码
3. 高级用户：直接在Coder中开发复杂实验
4. 专家用户：结合其他Python科学计算库扩展功能

八、下一步学习方向

• 探索Builder内置的示例实验
• 学习PsychoPy的核心API文档
• 尝试将简单实验扩展到多条件设计
• 了解数据收集和分析方法

通过本指南，你应该已经掌握了PsychoPy的基本使用方法。无论是简单的行为实验还是复杂的认知任务，PsychoPy都能提供强大的支持。建议从简单实验开始，逐步构建更复杂的研究设计。