oTree实验经济学工具高效配置指南：从环境搭建到运行测试

oTree是一款专为实验经济学研究打造的开源框架，能够帮助研究者快速构建和部署网页版经济实验。作为基于Python的实验平台，oTree结合了Django的强大后端能力与现代前端技术，为行为经济学实验提供了灵活的开发环境。无论是学术研究还是教学演示，oTree都能满足从简单博弈实验到复杂市场模拟的多样化需求。

项目价值定位：为什么选择oTree实验平台

oTree的核心优势在于其实验流程全周期管理能力，从实验设计、被试招募到数据收集分析，形成完整的研究闭环。相比传统实验方式，它具有三大核心价值：

• 跨平台兼容性：支持PC端与移动端访问，打破实验室空间限制
• 模块化设计：内置多种经典实验模板（如囚徒困境、公共品博弈等），可直接复用或二次开发
• 实时数据追踪：通过WebSocket技术实现实验过程数据的实时采集与监控

技术栈解析：oTree的核心技术架构

oTree采用多层次技术架构，各组件协同工作保障实验流畅运行：

后端核心框架

• Python 3.6+：作为主要开发语言，提供简洁的语法和丰富的科学计算库
• Django：Web应用基础框架，负责URL路由、模板渲染和数据库交互
• Channels：Django的扩展模块，实现WebSocket通信支持实时实验交互

前端与数据层

• Bootstrap：提供响应式布局支持，确保实验界面在不同设备上的一致性
• MySQL：关系型数据库，高效存储实验设计参数与被试行为数据

环境准备清单：10分钟完成系统兼容性检查

在开始安装前，请确认您的系统满足以下要求：

硬件最低配置

• CPU：双核处理器
• 内存：4GB RAM
• 存储：至少100MB可用空间

软件环境要求

• Python 3.6及以上版本（推荐3.8+）
• pip包管理器（通常随Python一同安装）
• MySQL 5.7或更高版本
• Git版本控制工具

可通过以下命令快速验证Python环境：

python --version  # 检查Python版本
pip --version     # 检查pip是否安装

分步实施指南：从零开始的配置流程

1. 获取项目代码库

打开终端，执行以下命令克隆官方代码仓库：

git clone https://gitcode.com/gh_mirrors/otr/oTree
cd oTree

2. 安装依赖包

使用pip安装项目所需的全部依赖：

pip install -r requirements.txt

🔧 注意事项：建议使用虚拟环境（如venv）隔离项目依赖，避免版本冲突

3. MySQL数据库配置

1. 登录MySQL创建专用数据库：

CREATE DATABASE otree_db CHARACTER SET utf8mb4;

2. 编辑项目根目录下的settings.py文件，修改数据库配置：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'otree_db',
        'USER': 'your_username',
        'PASSWORD': 'your_password',
        'HOST': 'localhost',
        'PORT': '3306',
    }
}

4. 数据库初始化

执行数据库迁移命令创建必要的数据表：

python manage.py migrate

✅ 看到"Applied"提示表示数据库初始化成功

5. 启动开发服务器

python manage.py runserver

在浏览器访问http://127.0.0.1:8000/，出现oTree欢迎页面即表示安装成功

常见问题排查：解决配置过程中的典型障碍

问题1：依赖安装失败

症状：执行pip install时出现"permission denied"错误
解决方案：使用用户级安装或虚拟环境

pip install --user -r requirements.txt  # 用户级安装

问题2：数据库连接失败

症状：执行migrate命令时提示"Access denied"
解决方案：检查MySQL用户名密码，确保数据库服务已启动

systemctl status mysql  # 检查MySQL服务状态

问题3：端口被占用

症状：runserver命令提示"Address already in use"
解决方案：指定其他端口启动服务器

python manage.py runserver 8001  # 使用8001端口

问题4：静态文件加载异常

症状：网页显示错乱，CSS样式未加载
解决方案：收集静态文件

python manage.py collectstatic

问题5：实验房间创建失败

症状：在管理界面创建房间时提示错误
解决方案：检查settings.py中的SECRET_KEY是否配置，确保其不为空值

扩展学习资源

官方文档：docs/setup.md
实验模板库：bargaining/、prisoner/
社区支持：项目内置的_rooms/目录包含示例房间配置文件，可作为实验设计参考

通过以上步骤，您已完成oTree实验平台的基础配置。如需深入学习高级功能，建议从修改现有实验模板开始，逐步掌握自定义实验设计的方法。实验过程中产生的数据会自动存储在MySQL数据库中，可通过Django管理界面或直接查询数据库进行分析。