新增wasm以优化实体update速度

This commit is contained in:
YHH
2025-06-08 21:50:50 +08:00
parent 0aa4791cf7
commit 8d0ad6b871
51 changed files with 5811 additions and 10773 deletions

View File

@@ -0,0 +1,768 @@
/**
* ECS框架性能基准测试
* 测试框架在不同场景下的性能表现
*/
import { Scene } from '../../ECS/Scene';
import { Entity } from '../../ECS/Entity';
import { Component } from '../../ECS/Component';
console.log('🚀 ECS框架性能基准测试');
console.log('============================================================');
console.log('测试目标: 评估ECS框架在不同场景下的性能表现');
console.log('============================================================');
/**
* 位置组件
*/
class PositionComponent extends Component {
public x: number = 0;
public y: number = 0;
constructor(x: number = 0, y: number = 0) {
super();
this.x = x;
this.y = y;
}
}
/**
* 速度组件
*/
class VelocityComponent extends Component {
public vx: number = 0;
public vy: number = 0;
constructor(vx: number = 0, vy: number = 0) {
super();
this.vx = vx;
this.vy = vy;
}
}
/**
* 生命值组件
*/
class HealthComponent extends Component {
public health: number = 100;
public maxHealth: number = 100;
constructor(health: number = 100) {
super();
this.health = health;
this.maxHealth = health;
}
}
/**
* 渲染组件
*/
class RenderComponent extends Component {
public sprite: string = '';
public visible: boolean = true;
constructor(sprite: string = '') {
super();
this.sprite = sprite;
}
}
/**
* AI组件
*/
class AIComponent extends Component {
public state: string = 'idle';
public target: Entity | null = null;
constructor(state: string = 'idle') {
super();
this.state = state;
}
}
/**
* 测试配置接口
*/
interface TestConfig {
entityCounts: number[];
queryIterations: number;
updateIterations: number;
}
/**
* 测试配置
*/
const TEST_CONFIG: TestConfig = {
entityCounts: [1000, 5000, 10000, 25000, 50000, 100000, 200000, 500000],
queryIterations: 1000,
updateIterations: 100
};
/**
* 性能测试结果
*/
interface PerformanceResult {
entityCount: number;
singleQuery: number;
multiQuery: number;
complexQuery: number;
tagQuery: number;
singleTagQuery: number;
entityUpdate: number;
memoryUsage: number;
}
/**
* 测试创建实体的性能
*/
function testEntityCreation(scene: Scene, count: number): {
totalTime: number;
averageTime: number;
entitiesPerSecond: number;
breakdown: {
entityCreation: number;
componentAddition: number;
tagAssignment: number;
};
} {
const startTime = performance.now();
let entityCreationTime = 0;
let componentAdditionTime = 0;
let tagAssignmentTime = 0;
// 批量创建实体(不添加组件)
const entityStart = performance.now();
const entities = scene.createEntities(count, "Entity");
entityCreationTime = performance.now() - entityStart;
// 批量添加组件
const componentStart = performance.now();
for (let i = 0; i < entities.length; i++) {
const entity = entities[i];
// 所有实体都有位置组件
entity.addComponent(new PositionComponent(
Math.random() * 1000,
Math.random() * 1000
));
// 70%的实体有速度组件
if (Math.random() < 0.7) {
entity.addComponent(new VelocityComponent(
(Math.random() - 0.5) * 10,
(Math.random() - 0.5) * 10
));
}
// 50%的实体有生命值组件
if (Math.random() < 0.5) {
entity.addComponent(new HealthComponent(
Math.floor(Math.random() * 100) + 50
));
}
// 30%的实体有渲染组件
if (Math.random() < 0.3) {
entity.addComponent(new RenderComponent(`sprite_${i % 10}`));
}
// 20%的实体有AI组件
if (Math.random() < 0.2) {
entity.addComponent(new AIComponent(['idle', 'patrol', 'chase'][Math.floor(Math.random() * 3)]));
}
}
componentAdditionTime = performance.now() - componentStart;
// 批量设置标签
const tagStart = performance.now();
for (const entity of entities) {
entity.tag = Math.floor(Math.random() * 10);
}
tagAssignmentTime = performance.now() - tagStart;
const totalTime = performance.now() - startTime;
return {
totalTime,
averageTime: totalTime / count,
entitiesPerSecond: count / (totalTime / 1000),
breakdown: {
entityCreation: entityCreationTime,
componentAddition: componentAdditionTime,
tagAssignment: tagAssignmentTime
}
};
}
/**
* 创建测试实体
*/
function createTestEntities(scene: Scene, count: number): Entity[] {
const entities: Entity[] = [];
for (let i = 0; i < count; i++) {
const entity = scene.createEntity(`Entity_${i}`);
// 所有实体都有位置组件
entity.addComponent(new PositionComponent(
Math.random() * 1000,
Math.random() * 1000
));
// 70%的实体有速度组件
if (Math.random() < 0.7) {
entity.addComponent(new VelocityComponent(
(Math.random() - 0.5) * 10,
(Math.random() - 0.5) * 10
));
}
// 50%的实体有生命值组件
if (Math.random() < 0.5) {
entity.addComponent(new HealthComponent(
Math.floor(Math.random() * 100) + 50
));
}
// 30%的实体有渲染组件
if (Math.random() < 0.3) {
entity.addComponent(new RenderComponent(`sprite_${i % 10}`));
}
// 20%的实体有AI组件
if (Math.random() < 0.2) {
entity.addComponent(new AIComponent(['idle', 'patrol', 'chase'][Math.floor(Math.random() * 3)]));
}
// 设置随机标签
entity.tag = Math.floor(Math.random() * 10);
entities.push(entity);
}
return entities;
}
/**
* 测试单组件查询性能
*/
function testSingleComponentQuery(scene: Scene, iterations: number): number {
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
scene.querySystem.queryAll(PositionComponent);
}
return performance.now() - startTime;
}
/**
* 测试多组件查询性能
*/
function testMultiComponentQuery(scene: Scene, iterations: number): number {
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
scene.querySystem.queryAll(PositionComponent, VelocityComponent);
}
return performance.now() - startTime;
}
/**
* 测试复杂查询性能
*/
function testComplexQuery(scene: Scene, iterations: number): number {
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
scene.querySystem.queryAll(PositionComponent, VelocityComponent, HealthComponent);
}
return performance.now() - startTime;
}
/**
* 测试标签查询性能
*/
function testTagQuery(scene: Scene, iterations: number): number {
const startTime = performance.now();
// 优化:预先获取所有标签查询结果,然后重复使用
// 这更符合实际游戏中的使用模式
const tags = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];
for (let i = 0; i < iterations; i++) {
// 批量查询所有标签
for (const tag of tags) {
scene.querySystem.queryByTag(tag);
}
}
return performance.now() - startTime;
}
/**
* 测试单个标签查询性能
*/
function testSingleTagQuery(scene: Scene, iterations: number): number {
const startTime = performance.now();
// 只查询标签0测试单个标签的查询性能和缓存效果
for (let i = 0; i < iterations; i++) {
scene.querySystem.queryByTag(0);
}
return performance.now() - startTime;
}
/**
* 测试实体更新性能
*/
function testEntityUpdate(scene: Scene, iterations: number): number {
const entities = scene.querySystem.queryAll(PositionComponent, VelocityComponent).entities;
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
for (const entity of entities) {
const pos = entity.getComponent(PositionComponent);
const vel = entity.getComponent(VelocityComponent);
if (pos && vel) {
pos.x += vel.vx;
pos.y += vel.vy;
}
}
}
return performance.now() - startTime;
}
/**
* 获取内存使用情况
*/
function getMemoryUsage(): number {
if (typeof process !== 'undefined' && process.memoryUsage) {
return process.memoryUsage().heapUsed / 1024 / 1024; // MB
}
return 0;
}
/**
* 运行性能测试
*/
function runPerformanceTest(scene: Scene, entityCount: number, config: TestConfig): PerformanceResult {
console.log(`\n📊 测试 ${entityCount.toLocaleString()} 个实体...`);
// 测试实体创建性能
const startMemory = getMemoryUsage();
console.log(` 🔧 测试实体创建性能...`);
const creationStats = testEntityCreation(scene, entityCount);
const endMemory = getMemoryUsage();
console.log(` 📈 实体创建性能分析:`);
console.log(` 总时间: ${creationStats.totalTime.toFixed(2)}ms`);
console.log(` 平均时间: ${creationStats.averageTime.toFixed(4)}ms/实体`);
console.log(` 创建速度: ${creationStats.entitiesPerSecond.toFixed(0)} 实体/秒`);
console.log(` 时间分解:`);
console.log(` - 实体创建: ${creationStats.breakdown.entityCreation.toFixed(2)}ms (${(creationStats.breakdown.entityCreation / creationStats.totalTime * 100).toFixed(1)}%)`);
console.log(` - 组件添加: ${creationStats.breakdown.componentAddition.toFixed(2)}ms (${(creationStats.breakdown.componentAddition / creationStats.totalTime * 100).toFixed(1)}%)`);
console.log(` - 标签分配: ${creationStats.breakdown.tagAssignment.toFixed(2)}ms (${(creationStats.breakdown.tagAssignment / creationStats.totalTime * 100).toFixed(1)}%)`);
console.log(` 内存使用: ${(endMemory - startMemory).toFixed(1)}MB`);
// 运行测试
console.log(` 🔍 执行查询测试...`);
const singleQuery = testSingleComponentQuery(scene, config.queryIterations);
const multiQuery = testMultiComponentQuery(scene, config.queryIterations);
const complexQuery = testComplexQuery(scene, config.queryIterations);
const tagQuery = testTagQuery(scene, config.queryIterations);
const singleTagQuery = testSingleTagQuery(scene, config.queryIterations);
console.log(` ⚡ 执行更新测试...`);
const entityUpdate = testEntityUpdate(scene, config.updateIterations);
console.log(` ✅ 测试完成`);
return {
entityCount,
singleQuery,
multiQuery,
complexQuery,
tagQuery,
singleTagQuery,
entityUpdate,
memoryUsage: endMemory - startMemory
};
}
/**
* 显示系统信息
*/
function displaySystemInfo(scene: Scene): void {
const status = scene.querySystem.getAccelerationStatus();
const stats = scene.querySystem.getStats();
console.log('\n🔍 系统信息:');
console.log(` 当前提供者: ${status.currentProvider}`);
console.log(` WebAssembly: ${status.wasmEnabled ? '已启用' : '未启用'}`);
console.log(` 可用提供者: ${status.availableProviders.join(', ')}`);
console.log(` 索引统计:`);
console.log(` 组件掩码索引: ${stats.indexStats.maskIndexSize}`);
console.log(` 组件类型索引: ${stats.indexStats.componentIndexSize}`);
console.log(` 标签索引: ${stats.indexStats.tagIndexSize}`);
console.log(` 名称索引: ${stats.indexStats.nameIndexSize}`);
if (status.performanceInfo?.cacheStats) {
console.log(` 查询缓存:`);
console.log(` 缓存大小: ${status.performanceInfo.cacheStats.size}`);
console.log(` 命中率: ${status.performanceInfo.cacheStats.hitRate}`);
}
}
/**
* 显示性能结果
*/
function displayResults(results: PerformanceResult[], scene: Scene): void {
console.log('\n📈 ECS框架性能测试结果');
console.log('='.repeat(130));
console.log('| 实体数量 | 单组件查询 | 双组件查询 | 三组件查询 | 多标签查询 | 单标签查询 | 实体更新 | 内存使用 |');
console.log('|' + '-'.repeat(128) + '|');
for (const result of results) {
const entityCount = result.entityCount.toLocaleString().padStart(9);
const singleQuery = `${result.singleQuery.toFixed(2)}ms`.padStart(10);
const multiQuery = `${result.multiQuery.toFixed(2)}ms`.padStart(10);
const complexQuery = `${result.complexQuery.toFixed(2)}ms`.padStart(10);
const tagQuery = `${result.tagQuery.toFixed(2)}ms`.padStart(10);
const singleTagQuery = `${result.singleTagQuery.toFixed(2)}ms`.padStart(10);
const entityUpdate = `${result.entityUpdate.toFixed(2)}ms`.padStart(9);
const memoryUsage = `${result.memoryUsage.toFixed(1)}MB`.padStart(9);
console.log(`| ${entityCount} | ${singleQuery} | ${multiQuery} | ${complexQuery} | ${tagQuery} | ${singleTagQuery} | ${entityUpdate} | ${memoryUsage} |`);
}
console.log('|' + '-'.repeat(128) + '|');
// 计算性能指标
const maxEntities = Math.max(...results.map(r => r.entityCount));
const maxResult = results.find(r => r.entityCount === maxEntities)!;
console.log(`\n🎯 性能峰值 (${maxEntities.toLocaleString()} 个实体):`);
console.log(` 单组件查询: ${(TEST_CONFIG.queryIterations / maxResult.singleQuery * 1000).toFixed(0)} 次/秒`);
console.log(` 双组件查询: ${(TEST_CONFIG.queryIterations / maxResult.multiQuery * 1000).toFixed(0)} 次/秒`);
console.log(` 三组件查询: ${(TEST_CONFIG.queryIterations / maxResult.complexQuery * 1000).toFixed(0)} 次/秒`);
console.log(` 多标签查询: ${(TEST_CONFIG.queryIterations * 10 / maxResult.tagQuery * 1000).toFixed(0)} 次/秒`);
console.log(` 单标签查询: ${(TEST_CONFIG.queryIterations / maxResult.singleTagQuery * 1000).toFixed(0)} 次/秒`);
console.log(` 实体更新: ${(maxResult.entityCount * TEST_CONFIG.updateIterations / maxResult.entityUpdate * 1000).toFixed(0)} 个/秒`);
console.log(` 内存效率: ${(maxResult.entityCount / (maxResult.memoryUsage || 1)).toFixed(0)} 实体/MB`);
// 性能评级
const avgQueryTime = (maxResult.singleQuery + maxResult.multiQuery + maxResult.complexQuery + maxResult.singleTagQuery) / 4;
let rating = '';
if (avgQueryTime < 50) rating = '🚀 优秀';
else if (avgQueryTime < 100) rating = '✅ 良好';
else if (avgQueryTime < 200) rating = '⚠️ 一般';
else rating = '❌ 需要优化';
console.log(`\n📊 性能评级: ${rating}`);
console.log(` 平均查询时间: ${avgQueryTime.toFixed(2)}ms`);
// 显示查询统计信息
const queryStats = scene.querySystem.getStats().queryStats;
console.log(`\n🔍 查询统计:`);
console.log(` 总查询次数: ${queryStats.totalQueries.toLocaleString()}`);
console.log(` 缓存命中: ${queryStats.cacheHits.toLocaleString()}`);
console.log(` 索引命中: ${queryStats.indexHits.toLocaleString()}`);
console.log(` 线性扫描: ${queryStats.linearScans.toLocaleString()}`);
console.log(` 缓存命中率: ${queryStats.cacheHitRate}`);
// 标签查询性能分析
console.log(`\n🏷 标签查询分析:`);
const tagQueryRatio = maxResult.tagQuery / maxResult.singleTagQuery;
console.log(` 多标签查询 vs 单标签查询: ${tagQueryRatio.toFixed(2)}x (预期约10x)`);
if (tagQueryRatio > 15) {
console.log(` ⚠️ 多标签查询性能异常,可能存在缓存问题`);
} else if (tagQueryRatio < 5) {
console.log(` ✅ 标签查询缓存效果良好`);
} else {
console.log(` 📊 标签查询性能正常`);
}
// 性能改进分析
const improvement = calculatePerformanceImprovement(results);
if (improvement) {
console.log(`\n📈 性能改进分析:`);
console.log(` 双组件查询改进: ${improvement.multiQuery}x`);
console.log(` 三组件查询改进: ${improvement.complexQuery}x`);
console.log(` 整体查询改进: ${improvement.overall}x`);
}
// 扩展性分析
console.log(`\n📊 扩展性分析:`);
analyzeScalability(results);
}
/**
* 计算性能改进(与优化前对比)
*/
function calculatePerformanceImprovement(results: PerformanceResult[]): {
multiQuery: string;
complexQuery: string;
overall: string;
} | null {
// 基于50,000实体的结果进行分析
const maxResult = results.find(r => r.entityCount === 50000);
if (!maxResult) return null;
// 优化前的基准时间(基于之前的测试结果)
const baselineMultiQuery = 1270.54; // ms
const baselineComplexQuery = 981.76; // ms
const multiImprovement = (baselineMultiQuery / maxResult.multiQuery).toFixed(2);
const complexImprovement = (baselineComplexQuery / maxResult.complexQuery).toFixed(2);
const overallImprovement = ((baselineMultiQuery + baselineComplexQuery) /
(maxResult.multiQuery + maxResult.complexQuery)).toFixed(2);
return {
multiQuery: multiImprovement,
complexQuery: complexImprovement,
overall: overallImprovement
};
}
/**
* 分析系统扩展性
*/
function analyzeScalability(results: PerformanceResult[]): void {
if (results.length < 2) return;
// 分析查询时间随实体数量的变化趋势
const first = results[0];
const last = results[results.length - 1];
const entityRatio = last.entityCount / first.entityCount;
const singleQueryRatio = last.singleQuery / first.singleQuery;
const multiQueryRatio = last.multiQuery / first.multiQuery;
const complexQueryRatio = last.complexQuery / first.complexQuery;
console.log(` 实体数量增长: ${entityRatio.toFixed(1)}x (${first.entityCount.toLocaleString()}${last.entityCount.toLocaleString()})`);
console.log(` 单组件查询时间增长: ${singleQueryRatio.toFixed(2)}x`);
console.log(` 双组件查询时间增长: ${multiQueryRatio.toFixed(2)}x`);
console.log(` 三组件查询时间增长: ${complexQueryRatio.toFixed(2)}x`);
// 计算复杂度
const avgComplexity = (singleQueryRatio + multiQueryRatio + complexQueryRatio) / 3;
let complexityRating = '';
if (avgComplexity < entityRatio * 0.1) complexityRating = '🚀 近似O(1) - 优秀';
else if (avgComplexity < entityRatio * 0.5) complexityRating = '✅ 亚线性 - 良好';
else if (avgComplexity < entityRatio) complexityRating = '⚠️ 接近线性 - 一般';
else complexityRating = '❌ 超线性 - 需要优化';
console.log(` 时间复杂度评估: ${complexityRating}`);
// 内存效率分析
const memoryEfficiencyFirst = first.entityCount / first.memoryUsage;
const memoryEfficiencyLast = last.entityCount / last.memoryUsage;
const memoryEfficiencyRatio = memoryEfficiencyLast / memoryEfficiencyFirst;
console.log(` 内存效率变化: ${memoryEfficiencyRatio.toFixed(2)}x (${memoryEfficiencyFirst.toFixed(0)}${memoryEfficiencyLast.toFixed(0)} 实体/MB)`);
}
/**
* 专门测试实体创建性能
*/
async function runEntityCreationBenchmark(): Promise<void> {
console.log('\n🚀 实体创建性能基准测试');
console.log('='.repeat(60));
const testCounts = [1000, 5000, 10000, 50000, 100000];
for (const count of testCounts) {
console.log(`\n📊 测试创建 ${count.toLocaleString()} 个实体:`);
// 创建新场景
const scene = new Scene();
// 测试创建性能
const stats = testEntityCreation(scene, count);
console.log(` 总时间: ${stats.totalTime.toFixed(2)}ms`);
console.log(` 平均时间: ${stats.averageTime.toFixed(4)}ms/实体`);
console.log(` 创建速度: ${stats.entitiesPerSecond.toFixed(0)} 实体/秒`);
console.log(` 时间分解:`);
console.log(` - 实体创建: ${stats.breakdown.entityCreation.toFixed(2)}ms (${(stats.breakdown.entityCreation / stats.totalTime * 100).toFixed(1)}%)`);
console.log(` - 组件添加: ${stats.breakdown.componentAddition.toFixed(2)}ms (${(stats.breakdown.componentAddition / stats.totalTime * 100).toFixed(1)}%)`);
console.log(` - 标签分配: ${stats.breakdown.tagAssignment.toFixed(2)}ms (${(stats.breakdown.tagAssignment / stats.totalTime * 100).toFixed(1)}%)`);
// 分析性能瓶颈
const { entityCreation, componentAddition, tagAssignment } = stats.breakdown;
const total = stats.totalTime;
console.log(` 性能瓶颈分析:`);
if (componentAddition / total > 0.5) {
console.log(` ⚠️ 组件添加是主要瓶颈 (${(componentAddition / total * 100).toFixed(1)}%)`);
}
if (entityCreation / total > 0.3) {
console.log(` ⚠️ 实体创建开销较高 (${(entityCreation / total * 100).toFixed(1)}%)`);
}
if (tagAssignment / total > 0.1) {
console.log(` ⚠️ 标签分配开销异常 (${(tagAssignment / total * 100).toFixed(1)}%)`);
}
// 分析组件添加性能(仅对较小的测试集)
if (count <= 10000) {
analyzeComponentAdditionPerformance(new Scene(), Math.min(count, 5000));
}
// 清理场景
scene.end();
}
console.log('\n📈 实体创建性能总结:');
console.log(' 主要性能瓶颈通常在组件添加阶段');
console.log(' 建议优化方向:');
console.log(' 1. 减少组件注册开销');
console.log(' 2. 优化位掩码计算');
console.log(' 3. 减少内存分配次数');
console.log(' 4. 使用对象池复用组件实例');
}
/**
* 测试组件添加性能的详细分析
*/
function analyzeComponentAdditionPerformance(scene: Scene, count: number): void {
console.log(`\n🔬 组件添加性能详细分析 (${count.toLocaleString()} 个实体):`);
// 创建实体但不添加组件
const entities = scene.createEntities(count, "TestEntity");
// 分别测试每种组件的添加性能
const componentTests = [
{
name: "PositionComponent",
create: () => new PositionComponent(Math.random() * 1000, Math.random() * 1000),
probability: 1.0
},
{
name: "VelocityComponent",
create: () => new VelocityComponent((Math.random() - 0.5) * 10, (Math.random() - 0.5) * 10),
probability: 0.7
},
{
name: "HealthComponent",
create: () => new HealthComponent(Math.floor(Math.random() * 100) + 50),
probability: 0.5
},
{
name: "RenderComponent",
create: () => new RenderComponent(`sprite_${Math.floor(Math.random() * 10)}`),
probability: 0.3
},
{
name: "AIComponent",
create: () => new AIComponent(['idle', 'patrol', 'chase'][Math.floor(Math.random() * 3)]),
probability: 0.2
}
];
for (const test of componentTests) {
const startTime = performance.now();
let addedCount = 0;
for (const entity of entities) {
if (Math.random() < test.probability) {
entity.addComponent(test.create());
addedCount++;
}
}
const endTime = performance.now();
const totalTime = endTime - startTime;
console.log(` ${test.name}:`);
console.log(` 添加数量: ${addedCount.toLocaleString()}`);
console.log(` 总时间: ${totalTime.toFixed(2)}ms`);
console.log(` 平均时间: ${(totalTime / addedCount).toFixed(4)}ms/组件`);
console.log(` 添加速度: ${(addedCount / (totalTime / 1000)).toFixed(0)} 组件/秒`);
}
}
/**
* 主测试函数
*/
async function runBenchmarks(): Promise<void> {
console.log('🎯 ECS框架性能基准测试');
console.log('='.repeat(60));
// 先运行实体创建性能测试
await runEntityCreationBenchmark();
// 然后运行完整的框架测试
console.log('\n🚀 完整框架性能测试');
console.log('='.repeat(60));
console.log(`\n⚙ 测试配置:`);
console.log(` 实体数量: ${TEST_CONFIG.entityCounts.map(n => n.toLocaleString()).join(', ')}`);
console.log(` 查询迭代: ${TEST_CONFIG.queryIterations.toLocaleString()}`);
console.log(` 更新迭代: ${TEST_CONFIG.updateIterations.toLocaleString()}`);
console.log(` 预计测试时间: ${(TEST_CONFIG.entityCounts.length * 2).toFixed(0)}-${(TEST_CONFIG.entityCounts.length * 5).toFixed(0)} 分钟`);
console.log('\n🔧 初始化ECS框架...');
// 初始化WebAssembly模块
try {
const { ecsCore } = await import('../../Utils/WasmCore');
await ecsCore.initialize();
console.log(`✅ WebAssembly模块: ${ecsCore.isUsingWasm() ? '已加载' : '未加载'}`);
} catch (error) {
console.log('⚠️ WebAssembly模块加载失败使用JavaScript实现');
}
const scene = new Scene();
// 等待初始化完成
await new Promise(resolve => setTimeout(resolve, 1000));
displaySystemInfo(scene);
const results: PerformanceResult[] = [];
const totalTests = TEST_CONFIG.entityCounts.length;
// 运行不同规模的测试
for (let i = 0; i < TEST_CONFIG.entityCounts.length; i++) {
const entityCount = TEST_CONFIG.entityCounts[i];
console.log(`\n🔄 进度: ${i + 1}/${totalTests} (${((i + 1) / totalTests * 100).toFixed(1)}%)`);
const result = runPerformanceTest(scene, entityCount, TEST_CONFIG);
results.push(result);
// 清理场景,准备下一轮测试
console.log(` 🧹 清理内存...`);
scene.end();
scene.begin();
// 强制垃圾回收
if (typeof global !== 'undefined' && global.gc) {
global.gc();
}
// 大规模测试间隔稍作休息
if (entityCount >= 100000) {
console.log(` ⏱️ 等待系统稳定...`);
await new Promise(resolve => setTimeout(resolve, 2000));
}
}
displayResults(results, scene);
scene.end();
console.log('\n✅ 性能测试完成!');
console.log(`📊 总测试时间: ${((Date.now() - startTime) / 1000 / 60).toFixed(1)} 分钟`);
}
// 记录开始时间
const startTime = Date.now();
// 运行测试
runBenchmarks().catch(error => {
console.error('❌ 测试失败:', error);
});

View File

@@ -0,0 +1,53 @@
const { Scene } = require('./bin/ECS/Scene.js');
const { Component } = require('./bin/ECS/Component.js');
// 简单的组件类
class TestComponent extends Component {
constructor(value) {
super();
this.value = value;
}
}
console.log('🔬 组件添加性能分析');
// 创建场景和实体
const scene = new Scene();
console.log('✅ 创建场景完成');
const startCreate = performance.now();
const entities = scene.createEntities(5000, 'TestEntity');
const endCreate = performance.now();
console.log(`✅ 创建了 ${entities.length} 个实体,耗时: ${(endCreate - startCreate).toFixed(2)}ms`);
// 测试单个组件添加性能
console.log('\n📊 测试组件添加性能:');
const startAdd = performance.now();
for (let i = 0; i < entities.length; i++) {
const entity = entities[i];
entity.addComponent(new TestComponent(i));
}
const endAdd = performance.now();
const addTime = endAdd - startAdd;
console.log(`添加 ${entities.length} 个组件耗时: ${addTime.toFixed(2)}ms`);
console.log(`平均每个组件: ${(addTime / entities.length).toFixed(4)}ms`);
console.log(`添加速度: ${(entities.length / (addTime / 1000)).toFixed(0)} 组件/秒`);
// 测试组件获取性能
console.log('\n📊 测试组件获取性能:');
const startGet = performance.now();
for (let i = 0; i < entities.length; i++) {
const entity = entities[i];
const component = entity.getComponent(TestComponent);
}
const endGet = performance.now();
const getTime = endGet - startGet;
console.log(`获取 ${entities.length} 个组件耗时: ${getTime.toFixed(2)}ms`);
console.log(`平均每个组件: ${(getTime / entities.length).toFixed(4)}ms`);
console.log(`获取速度: ${(entities.length / (getTime / 1000)).toFixed(0)} 组件/秒`);

View File

@@ -0,0 +1,199 @@
import { BitMaskOptimizer } from '../../ECS/Core/BitMaskOptimizer';
/**
* 位掩码优化器测试
*/
function testBitMaskOptimizer(): void {
console.log('🧪 测试位掩码优化器');
const optimizer = BitMaskOptimizer.getInstance();
optimizer.reset();
// 测试组件类型注册
console.log(' 📝 测试组件类型注册...');
const positionId = optimizer.registerComponentType('Position');
const velocityId = optimizer.registerComponentType('Velocity');
const healthId = optimizer.registerComponentType('Health');
console.log(` Position ID: ${positionId}`);
console.log(` Velocity ID: ${velocityId}`);
console.log(` Health ID: ${healthId}`);
// 测试单个组件掩码
console.log(' 🎯 测试单个组件掩码...');
const positionMask = optimizer.createSingleComponentMask('Position');
const velocityMask = optimizer.createSingleComponentMask('Velocity');
console.log(` Position掩码: ${positionMask.toString(2)}`);
console.log(` Velocity掩码: ${velocityMask.toString(2)}`);
// 测试组合掩码
console.log(' 🔗 测试组合掩码...');
const combinedMask = optimizer.createCombinedMask(['Position', 'Velocity']);
console.log(` Position+Velocity掩码: ${combinedMask.toString(2)}`);
// 测试掩码包含检查
console.log(' ✅ 测试掩码包含检查...');
const hasPosition = optimizer.maskContainsComponent(combinedMask, 'Position');
const hasVelocity = optimizer.maskContainsComponent(combinedMask, 'Velocity');
const hasHealth = optimizer.maskContainsComponent(combinedMask, 'Health');
console.log(` 包含Position: ${hasPosition}`);
console.log(` 包含Velocity: ${hasVelocity}`);
console.log(` 包含Health: ${hasHealth}`);
// 测试掩码操作
console.log(' 🔧 测试掩码操作...');
let entityMask = 0n;
entityMask = optimizer.addComponentToMask(entityMask, 'Position');
entityMask = optimizer.addComponentToMask(entityMask, 'Health');
console.log(` 添加Position和Health后: ${entityMask.toString(2)}`);
const hasAll = optimizer.maskContainsAllComponents(entityMask, ['Position', 'Health']);
const hasAny = optimizer.maskContainsAnyComponent(entityMask, ['Position', 'Velocity']);
console.log(` 包含Position和Health: ${hasAll}`);
console.log(` 包含Position或Velocity: ${hasAny}`);
// 测试掩码分析
console.log(' 📊 测试掩码分析...');
const componentNames = optimizer.maskToComponentNames(entityMask);
const componentCount = optimizer.getComponentCount(entityMask);
console.log(` 掩码包含的组件: ${componentNames.join(', ')}`);
console.log(` 组件数量: ${componentCount}`);
// 测试缓存统计
console.log(' 📈 测试缓存统计...');
const stats = optimizer.getCacheStats();
console.log(` 缓存大小: ${stats.size}`);
console.log(` 组件类型数量: ${stats.componentTypes}`);
// 测试预计算常用掩码
console.log(' ⚡ 测试预计算常用掩码...');
const commonCombinations = [
['Position', 'Velocity'],
['Position', 'Health'],
['Position', 'Velocity', 'Health']
];
optimizer.precomputeCommonMasks(commonCombinations);
const statsAfterPrecompute = optimizer.getCacheStats();
console.log(` 预计算后缓存大小: ${statsAfterPrecompute.size}`);
console.log('✅ 位掩码优化器测试完成');
}
/**
* 性能测试
*/
function testBitMaskPerformance(): void {
console.log('\n🚀 位掩码优化器性能测试');
const optimizer = BitMaskOptimizer.getInstance();
optimizer.reset();
// 注册组件类型
const componentTypes = ['Position', 'Velocity', 'Health', 'Render', 'AI', 'Physics', 'Audio', 'Network'];
for (const type of componentTypes) {
optimizer.registerComponentType(type);
}
const iterations = 100000;
// 测试单个掩码创建性能
console.log(' 🔥 测试单个掩码创建性能...');
let start = performance.now();
for (let i = 0; i < iterations; i++) {
optimizer.createSingleComponentMask('Position');
}
let end = performance.now();
console.log(` ${iterations}次单个掩码创建: ${(end - start).toFixed(2)}ms`);
// 测试组合掩码创建性能
console.log(' 🔥 测试组合掩码创建性能...');
start = performance.now();
for (let i = 0; i < iterations; i++) {
optimizer.createCombinedMask(['Position', 'Velocity', 'Health']);
}
end = performance.now();
console.log(` ${iterations}次组合掩码创建: ${(end - start).toFixed(2)}ms`);
// 测试掩码检查性能
console.log(' 🔥 测试掩码检查性能...');
const testMask = optimizer.createCombinedMask(['Position', 'Velocity', 'Health']);
start = performance.now();
for (let i = 0; i < iterations; i++) {
optimizer.maskContainsComponent(testMask, 'Position');
optimizer.maskContainsComponent(testMask, 'AI');
}
end = performance.now();
console.log(` ${iterations * 2}次掩码检查: ${(end - start).toFixed(2)}ms`);
// 对比原生位操作性能
console.log(' ⚖️ 对比原生位操作性能...');
const positionBit = 1n << 0n;
const velocityBit = 1n << 1n;
const healthBit = 1n << 2n;
const nativeMask = positionBit | velocityBit | healthBit;
start = performance.now();
for (let i = 0; i < iterations; i++) {
(nativeMask & positionBit) !== 0n;
(nativeMask & (1n << 7n)) !== 0n; // AI位
}
end = performance.now();
console.log(` ${iterations * 2}次原生位操作: ${(end - start).toFixed(2)}ms`);
console.log('✅ 性能测试完成');
}
/**
* 内存使用测试
*/
function testBitMaskMemoryUsage(): void {
console.log('\n💾 位掩码优化器内存使用测试');
const optimizer = BitMaskOptimizer.getInstance();
optimizer.reset();
// 注册大量组件类型
console.log(' 📝 注册组件类型...');
for (let i = 0; i < 100; i++) {
optimizer.registerComponentType(`Component${i}`);
}
// 创建大量掩码组合
console.log(' 🔗 创建掩码组合...');
const maskCount = 1000;
for (let i = 0; i < maskCount; i++) {
const componentCount = Math.floor(Math.random() * 5) + 1;
const components: string[] = [];
for (let j = 0; j < componentCount; j++) {
components.push(`Component${Math.floor(Math.random() * 100)}`);
}
optimizer.createCombinedMask(components);
}
const stats = optimizer.getCacheStats();
console.log(` 📊 最终统计:`);
console.log(` 组件类型数量: ${stats.componentTypes}`);
console.log(` 缓存掩码数量: ${stats.size}`);
console.log(` 平均每个掩码占用: ~${(stats.size * 64 / 1024).toFixed(2)} KB`);
console.log('✅ 内存使用测试完成');
}
// 运行所有测试
export function runBitMaskOptimizerTests(): void {
console.log('🧪 位掩码优化器测试套件');
console.log('='.repeat(50));
testBitMaskOptimizer();
testBitMaskPerformance();
testBitMaskMemoryUsage();
console.log('\n✅ 所有测试完成');
}

View File

@@ -0,0 +1,189 @@
import { ComponentPool, ComponentPoolManager } from '../../ECS/Core/ComponentPool';
import { Component } from '../../ECS/Component';
/**
* 测试用组件
*/
class TestComponent extends Component {
public value: number = 0;
constructor(value: number = 0) {
super();
this.value = value;
}
reset(): void {
this.value = 0;
}
}
/**
* 运行组件对象池测试
*/
export function runComponentPoolTests(): void {
console.log('🧪 组件对象池测试');
console.log('='.repeat(50));
testBasicFunctionality();
testPoolManager();
testPerformance();
console.log('✅ 组件对象池测试完成');
}
/**
* 基础功能测试
*/
function testBasicFunctionality(): void {
console.log('\n📝 基础功能测试...');
const pool = new ComponentPool(
() => new TestComponent(),
(component) => component.reset(),
10
);
// 测试获取新组件实例
console.log(' 测试获取新组件实例...');
const component = pool.acquire();
console.assert(component instanceof TestComponent, '应该返回TestComponent实例');
console.assert(component.value === 0, '新组件的值应该为0');
// 测试释放和复用
console.log(' 测试组件释放和复用...');
component.value = 42;
pool.release(component);
console.assert(pool.getAvailableCount() === 1, '池中应该有1个可用组件');
const reusedComponent = pool.acquire();
console.assert(reusedComponent === component, '应该复用同一个组件实例');
console.assert(reusedComponent.value === 0, '复用的组件应该被重置');
// 测试预填充
console.log(' 测试对象池预填充...');
pool.prewarm(5);
console.assert(pool.getAvailableCount() === 5, '预填充后应该有5个可用组件');
const components: TestComponent[] = [];
for (let i = 0; i < 5; i++) {
components.push(pool.acquire());
}
console.assert(pool.getAvailableCount() === 0, '获取5个组件后池应该为空');
// 测试最大容量限制
console.log(' 测试最大容量限制...');
pool.prewarm(10);
const extraComponent = new TestComponent();
pool.release(extraComponent);
console.assert(pool.getAvailableCount() === 10, '不应该超过最大容量');
// 测试清空池
console.log(' 测试清空对象池...');
pool.clear();
console.assert(pool.getAvailableCount() === 0, '清空后池应该为空');
console.log(' ✅ 基础功能测试通过');
}
/**
* 池管理器测试
*/
function testPoolManager(): void {
console.log('\n📝 池管理器测试...');
const manager = ComponentPoolManager.getInstance();
manager.clearAll();
// 测试单例模式
console.log(' 测试单例模式...');
const manager1 = ComponentPoolManager.getInstance();
const manager2 = ComponentPoolManager.getInstance();
console.assert(manager1 === manager2, '应该返回同一个实例');
// 测试注册组件池
console.log(' 测试注册组件池...');
manager.registerPool(
'TestComponent',
() => new TestComponent(),
(component) => component.reset(),
5
);
const stats = manager.getPoolStats();
console.assert(stats.has('TestComponent'), '应该包含已注册的组件类型');
console.assert(stats.get('TestComponent')?.maxSize === 5, '最大容量应该为5');
// 测试获取和释放组件
console.log(' 测试获取和释放组件...');
const component = manager.acquireComponent<TestComponent>('TestComponent');
console.assert(component instanceof TestComponent, '应该返回TestComponent实例');
if (component) {
component.value = 42;
manager.releaseComponent('TestComponent', component);
const reusedComponent = manager.acquireComponent<TestComponent>('TestComponent');
console.assert(reusedComponent === component, '应该复用同一个组件');
console.assert(reusedComponent?.value === 0, '复用的组件应该被重置');
}
// 测试预热所有池
console.log(' 测试预热所有池...');
manager.registerPool('TestComponent1', () => new TestComponent());
manager.registerPool('TestComponent2', () => new TestComponent());
manager.prewarmAll(3);
const finalStats = manager.getPoolStats();
console.assert(finalStats.get('TestComponent1')?.available === 3, 'TestComponent1应该有3个可用组件');
console.assert(finalStats.get('TestComponent2')?.available === 3, 'TestComponent2应该有3个可用组件');
// 测试未注册的组件类型
console.log(' 测试未注册的组件类型...');
const nullComponent = manager.acquireComponent('NonExistentComponent');
console.assert(nullComponent === null, '未注册的组件类型应该返回null');
manager.clearAll();
console.log(' ✅ 池管理器测试通过');
}
/**
* 性能测试
*/
function testPerformance(): void {
console.log('\n📝 性能测试...');
const pool = new ComponentPool(() => new TestComponent());
const iterations = 10000;
// 预热池
pool.prewarm(100);
// 测试对象池性能
const poolStart = performance.now();
for (let i = 0; i < iterations; i++) {
const component = pool.acquire();
pool.release(component);
}
const poolEnd = performance.now();
const poolTime = poolEnd - poolStart;
// 测试直接创建性能
const directStart = performance.now();
for (let i = 0; i < iterations; i++) {
new TestComponent();
}
const directEnd = performance.now();
const directTime = directEnd - directStart;
console.log(` 对象池时间: ${poolTime.toFixed(2)}ms`);
console.log(` 直接创建时间: ${directTime.toFixed(2)}ms`);
const improvement = ((directTime - poolTime) / directTime * 100);
console.log(` 性能提升: ${improvement.toFixed(1)}%`);
if (poolTime < directTime) {
console.log(' ✅ 对象池性能测试通过 - 比直接创建更快');
} else {
console.log(' ⚠️ 对象池在小规模测试中可能不如直接创建快');
}
}

View File

@@ -1,420 +0,0 @@
#!/usr/bin/env node
/**
* ECS框架基准测试 - 简化版本
* 专门测试框架本身的性能不依赖复杂的ECS实现
*/
console.log('🚀 ECS框架性能基准测试');
console.log('='.repeat(60));
console.log('测试目标: 框架本身的性能极限,不包含复杂游戏逻辑');
console.log('='.repeat(60));
// 模拟简单的实体和组件
class MockEntity {
public id: number;
public components = new Map<string, any>();
public tags = new Set<string>();
public enabled: boolean = true;
constructor(id: number) {
this.id = id;
}
addComponent(type: string, data: any): void {
this.components.set(type, data);
}
getComponent(type: string): any {
return this.components.get(type);
}
hasComponent(type: string): boolean {
return this.components.has(type);
}
removeComponent(type: string): void {
this.components.delete(type);
}
addTag(tag: string): void {
this.tags.add(tag);
}
hasTag(tag: string): boolean {
return this.tags.has(tag);
}
removeTag(tag: string): void {
this.tags.delete(tag);
}
}
// 模拟查询系统
class MockQuery {
private entities: MockEntity[] = [];
constructor(entities: MockEntity[]) {
this.entities = entities;
}
// 查询包含指定组件的实体
withComponents(...componentTypes: string[]): MockEntity[] {
return this.entities.filter(entity =>
componentTypes.every(type => entity.hasComponent(type))
);
}
// 查询包含指定标签的实体
withTags(...tags: string[]): MockEntity[] {
return this.entities.filter(entity =>
tags.every(tag => entity.hasTag(tag))
);
}
// 查询启用的实体
enabled(): MockEntity[] {
return this.entities.filter(entity => entity.enabled);
}
// 查询禁用的实体
disabled(): MockEntity[] {
return this.entities.filter(entity => !entity.enabled);
}
// 复合查询:组件 + 标签
withComponentsAndTags(componentTypes: string[], tags: string[]): MockEntity[] {
return this.entities.filter(entity =>
componentTypes.every(type => entity.hasComponent(type)) &&
tags.every(tag => entity.hasTag(tag)) &&
entity.enabled
);
}
// 排除查询:不包含指定组件
withoutComponents(...componentTypes: string[]): MockEntity[] {
return this.entities.filter(entity =>
!componentTypes.some(type => entity.hasComponent(type))
);
}
}
// 测试函数
function testEntityCreation(count: number): number {
const startTime = performance.now();
const entities: MockEntity[] = [];
for (let i = 0; i < count; i++) {
const entity = new MockEntity(i);
entity.addComponent('position', { x: i * 0.1, y: i * 0.2 });
entity.addComponent('velocity', { vx: 1, vy: 1 });
// 添加一些标签和状态
if (i % 2 === 0) entity.addTag('even');
if (i % 3 === 0) entity.addTag('player');
if (i % 5 === 0) entity.addTag('enemy');
if (i % 10 === 0) entity.enabled = false;
entities.push(entity);
}
return performance.now() - startTime;
}
function testComponentAccess(entities: MockEntity[], iterations: number): number {
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
for (const entity of entities) {
const pos = entity.getComponent('position');
const vel = entity.getComponent('velocity');
if (pos && vel) {
pos.x += vel.vx * 0.016;
pos.y += vel.vy * 0.016;
}
}
}
return performance.now() - startTime;
}
function testComponentAddRemove(entities: MockEntity[], iterations: number): number {
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
for (const entity of entities) {
entity.addComponent('temp', { value: i });
entity.removeComponent('temp');
}
}
return performance.now() - startTime;
}
function testSingleComponentQuery(entities: MockEntity[], iterations: number): number {
const query = new MockQuery(entities);
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
const result = query.withComponents('position');
}
return performance.now() - startTime;
}
function testMultiComponentQuery(entities: MockEntity[], iterations: number): number {
const query = new MockQuery(entities);
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
const result = query.withComponents('position', 'velocity');
}
return performance.now() - startTime;
}
function testTagQuery(entities: MockEntity[], iterations: number): number {
const query = new MockQuery(entities);
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
const players = query.withTags('player');
const enemies = query.withTags('enemy');
}
return performance.now() - startTime;
}
function testComplexQuery(entities: MockEntity[], iterations: number): number {
const query = new MockQuery(entities);
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
const result = query.withComponentsAndTags(['position', 'velocity'], ['player']);
}
return performance.now() - startTime;
}
function testExclusionQuery(entities: MockEntity[], iterations: number): number {
const query = new MockQuery(entities);
const startTime = performance.now();
for (let i = 0; i < iterations; i++) {
const result = query.withoutComponents('temp', 'disabled');
}
return performance.now() - startTime;
}
function testComponentExistence(entities: MockEntity[], iterations: number): number {
const startTime = performance.now();
let count = 0;
for (let i = 0; i < iterations; i++) {
for (const entity of entities) {
if (entity.hasComponent('position') && entity.hasComponent('velocity')) {
count++;
}
}
}
return performance.now() - startTime;
}
// 运行基准测试
async function runBenchmarks(): Promise<void> {
console.log('\n📊 1. 实体创建性能测试');
console.log('-'.repeat(50));
const entityCounts = [1000, 5000, 10000, 20000, 50000];
for (const count of entityCounts) {
const createTime = testEntityCreation(count);
const entitiesPerSecond = count / (createTime / 1000);
const timePerEntity = createTime / count;
console.log(`${count.toString().padStart(6)} 个实体: ${createTime.toFixed(2)}ms (${entitiesPerSecond.toFixed(0)}个/秒, ${timePerEntity.toFixed(4)}ms/个)`);
}
console.log('\n🔍 2. 组件访问性能测试');
console.log('-'.repeat(50));
const testEntities: MockEntity[] = [];
for (let i = 0; i < 5000; i++) {
const entity = new MockEntity(i);
entity.addComponent('position', { x: i * 0.1, y: i * 0.2 });
entity.addComponent('velocity', { vx: 1, vy: 1 });
// 添加标签和状态
if (i % 2 === 0) entity.addTag('even');
if (i % 3 === 0) entity.addTag('player');
if (i % 5 === 0) entity.addTag('enemy');
if (i % 10 === 0) entity.enabled = false;
testEntities.push(entity);
}
const accessIterations = [100, 500, 1000, 2000];
for (const iterations of accessIterations) {
const accessTime = testComponentAccess(testEntities, iterations);
const accessesPerSecond = (testEntities.length * iterations) / (accessTime / 1000);
const timePerAccess = accessTime / (testEntities.length * iterations);
console.log(`${iterations.toString().padStart(4)} 次迭代: ${accessTime.toFixed(2)}ms (${accessesPerSecond.toFixed(0)}次访问/秒, ${(timePerAccess * 1000).toFixed(3)}μs/次)`);
}
console.log('\n🧪 3. 组件添加/删除性能测试');
console.log('-'.repeat(50));
const addRemoveIterations = [100, 500, 1000];
for (const iterations of addRemoveIterations) {
const addRemoveTime = testComponentAddRemove(testEntities, iterations);
const operationsPerSecond = (testEntities.length * iterations * 2) / (addRemoveTime / 1000); // *2 for add+remove
const timePerOperation = addRemoveTime / (testEntities.length * iterations * 2);
console.log(`${iterations.toString().padStart(4)} 次迭代: ${addRemoveTime.toFixed(2)}ms (${operationsPerSecond.toFixed(0)}次操作/秒, ${(timePerOperation * 1000).toFixed(3)}μs/次)`);
}
console.log('\n🔎 4. 查询系统性能测试');
console.log('-'.repeat(50));
const queryIterations = [100, 500, 1000];
console.log('4.1 单组件查询:');
for (const iterations of queryIterations) {
const queryTime = testSingleComponentQuery(testEntities, iterations);
const queriesPerSecond = iterations / (queryTime / 1000);
const timePerQuery = queryTime / iterations;
console.log(` ${iterations.toString().padStart(4)} 次查询: ${queryTime.toFixed(2)}ms (${queriesPerSecond.toFixed(0)}次/秒, ${timePerQuery.toFixed(3)}ms/次)`);
}
console.log('4.2 多组件查询:');
for (const iterations of queryIterations) {
const queryTime = testMultiComponentQuery(testEntities, iterations);
const queriesPerSecond = iterations / (queryTime / 1000);
const timePerQuery = queryTime / iterations;
console.log(` ${iterations.toString().padStart(4)} 次查询: ${queryTime.toFixed(2)}ms (${queriesPerSecond.toFixed(0)}次/秒, ${timePerQuery.toFixed(3)}ms/次)`);
}
console.log('4.3 标签查询:');
for (const iterations of queryIterations) {
const queryTime = testTagQuery(testEntities, iterations);
const queriesPerSecond = (iterations * 2) / (queryTime / 1000); // *2 for player+enemy queries
const timePerQuery = queryTime / (iterations * 2);
console.log(` ${iterations.toString().padStart(4)} 次查询: ${queryTime.toFixed(2)}ms (${queriesPerSecond.toFixed(0)}次/秒, ${timePerQuery.toFixed(3)}ms/次)`);
}
console.log('4.4 复合查询 (组件+标签):');
for (const iterations of queryIterations) {
const queryTime = testComplexQuery(testEntities, iterations);
const queriesPerSecond = iterations / (queryTime / 1000);
const timePerQuery = queryTime / iterations;
console.log(` ${iterations.toString().padStart(4)} 次查询: ${queryTime.toFixed(2)}ms (${queriesPerSecond.toFixed(0)}次/秒, ${timePerQuery.toFixed(3)}ms/次)`);
}
console.log('4.5 排除查询:');
for (const iterations of queryIterations) {
const queryTime = testExclusionQuery(testEntities, iterations);
const queriesPerSecond = iterations / (queryTime / 1000);
const timePerQuery = queryTime / iterations;
console.log(` ${iterations.toString().padStart(4)} 次查询: ${queryTime.toFixed(2)}ms (${queriesPerSecond.toFixed(0)}次/秒, ${timePerQuery.toFixed(3)}ms/次)`);
}
console.log('4.6 组件存在性检查:');
for (const iterations of queryIterations) {
const checkTime = testComponentExistence(testEntities, iterations);
const checksPerSecond = (testEntities.length * iterations) / (checkTime / 1000);
const timePerCheck = checkTime / (testEntities.length * iterations);
console.log(` ${iterations.toString().padStart(4)} 次迭代: ${checkTime.toFixed(2)}ms (${checksPerSecond.toFixed(0)}次检查/秒, ${(timePerCheck * 1000).toFixed(3)}μs/次)`);
}
console.log('\n🎯 5. 寻找性能极限');
console.log('-'.repeat(50));
const limitTestSizes = [10000, 25000, 50000, 100000, 200000];
const targetFrameTime = 16.67; // 60FPS
for (const size of limitTestSizes) {
// 强制垃圾回收以获得更一致的测试结果
try {
if (typeof globalThis !== 'undefined' && (globalThis as any).gc) {
(globalThis as any).gc();
}
} catch (e) {
// 忽略垃圾回收错误
}
const entities: MockEntity[] = [];
// 创建实体 - 简化结构,只测试核心性能
const createStart = performance.now();
for (let i = 0; i < size; i++) {
const entity = new MockEntity(i);
entity.addComponent('position', { x: i * 0.1, y: i * 0.2 });
entity.addComponent('velocity', { vx: 1, vy: 1 });
entities.push(entity);
}
const createTime = performance.now() - createStart;
// 预热测试让JavaScript引擎优化代码
for (let warmup = 0; warmup < 10; warmup++) {
for (const entity of entities) {
const pos = entity.getComponent('position');
const vel = entity.getComponent('velocity');
if (pos && vel) {
pos.x += vel.vx * 0.016;
pos.y += vel.vy * 0.016;
}
}
}
// 使用固定时间测试而不是固定次数,这样更能反映真实性能
const testTimeMs = 1000; // 测试1秒钟
let frameCount = 0;
let totalFrameTime = 0;
const startTime = performance.now();
while (performance.now() - startTime < testTimeMs) {
const frameStart = performance.now();
for (const entity of entities) {
const pos = entity.getComponent('position');
const vel = entity.getComponent('velocity');
if (pos && vel) {
pos.x += vel.vx * 0.016;
pos.y += vel.vy * 0.016;
}
}
const frameTime = performance.now() - frameStart;
totalFrameTime += frameTime;
frameCount++;
}
const avgFrameTime = totalFrameTime / frameCount;
const fps = 1000 / avgFrameTime;
const actualFps = frameCount / ((performance.now() - startTime) / 1000);
const status = avgFrameTime <= targetFrameTime ? '✅' : avgFrameTime <= targetFrameTime * 2 ? '⚠️' : '❌';
console.log(`${size.toString().padStart(6)} 个实体: 创建${createTime.toFixed(2)}ms, 处理${avgFrameTime.toFixed(3)}ms/帧, 理论${fps.toFixed(1)}FPS, 实际${actualFps.toFixed(1)}FPS ${status}`);
console.log(`${' '.repeat(14)} 测试${frameCount}帧, 总时间${(performance.now() - startTime).toFixed(0)}ms`);
if (avgFrameTime > targetFrameTime * 3) {
console.log(`💥 性能极限: 约 ${size} 个实体时框架开始出现严重性能问题`);
break;
}
}
console.log('\n' + '='.repeat(60));
console.log('✅ ECS框架基准测试完成');
}
// 运行测试
runBenchmarks().catch(console.error);

View File

@@ -0,0 +1,182 @@
import { runBitMaskOptimizerTests } from './Unit/bitmask-optimizer.test';
import { runComponentPoolTests } from './Unit/component-pool.test';
/**
* 测试运行器 - 统一运行所有测试
*/
export class TestRunner {
private results: Map<string, { passed: number; failed: number; duration: number }> = new Map();
/**
* 运行所有单元测试
*/
async runUnitTests(): Promise<void> {
console.log('🧪 运行单元测试');
console.log('='.repeat(50));
await this.runTest('组件对象池', runComponentPoolTests);
await this.runTest('位掩码优化器', runBitMaskOptimizerTests);
console.log('\n📊 单元测试总结:');
this.printSummary();
}
/**
* 运行性能测试
*/
async runPerformanceTests(): Promise<void> {
console.log('\n🚀 运行性能测试');
console.log('='.repeat(50));
// 性能测试需要从benchmark.ts文件中导入
console.log('⚠️ 性能测试需要单独运行 - 请使用: node benchmark.ts');
console.log('\n📊 性能测试总结:');
this.printSummary();
}
/**
* 运行集成测试
*/
async runIntegrationTests(): Promise<void> {
console.log('\n🔗 运行集成测试');
console.log('='.repeat(50));
// 集成测试待实现
console.log('⚠️ 集成测试尚未实现');
}
/**
* 运行所有测试
*/
async runAllTests(): Promise<void> {
console.log('🎯 ECS框架完整测试套件');
console.log('='.repeat(60));
const startTime = performance.now();
await this.runUnitTests();
await this.runPerformanceTests();
await this.runIntegrationTests();
const endTime = performance.now();
const totalDuration = endTime - startTime;
console.log('\n✅ 所有测试完成');
console.log(`🕐 总测试时间: ${(totalDuration / 1000).toFixed(2)}`);
this.printFinalSummary();
}
/**
* 运行单个测试
*/
private async runTest(testName: string, testFunction: () => void | Promise<void>): Promise<void> {
console.log(`\n▶ 开始测试: ${testName}`);
const startTime = performance.now();
let passed = 0;
let failed = 0;
try {
await testFunction();
passed = 1;
console.log(`${testName} 测试通过`);
} catch (error) {
failed = 1;
console.error(`${testName} 测试失败:`, error);
}
const endTime = performance.now();
const duration = endTime - startTime;
this.results.set(testName, { passed, failed, duration });
console.log(`⏱️ 耗时: ${duration.toFixed(2)}ms`);
}
/**
* 打印测试摘要
*/
private printSummary(): void {
let totalPassed = 0;
let totalFailed = 0;
let totalDuration = 0;
for (const [name, result] of this.results) {
totalPassed += result.passed;
totalFailed += result.failed;
totalDuration += result.duration;
const status = result.failed > 0 ? '❌' : '✅';
console.log(` ${status} ${name}: ${result.duration.toFixed(2)}ms`);
}
console.log(`\n📈 测试统计:`);
console.log(` 通过: ${totalPassed}`);
console.log(` 失败: ${totalFailed}`);
console.log(` 总时间: ${totalDuration.toFixed(2)}ms`);
console.log(` 成功率: ${totalPassed + totalFailed > 0 ? (totalPassed / (totalPassed + totalFailed) * 100).toFixed(1) : 0}%`);
}
/**
* 打印最终测试摘要
*/
private printFinalSummary(): void {
console.log('\n📋 最终测试报告');
console.log('='.repeat(60));
let totalPassed = 0;
let totalFailed = 0;
for (const [, result] of this.results) {
totalPassed += result.passed;
totalFailed += result.failed;
}
if (totalFailed === 0) {
console.log('🎉 所有测试都通过了!');
} else {
console.log(`⚠️ 有 ${totalFailed} 个测试失败`);
}
console.log(`📊 测试覆盖率: ${this.results.size} 个测试模块`);
console.log(`✅ 通过率: ${totalPassed + totalFailed > 0 ? (totalPassed / (totalPassed + totalFailed) * 100).toFixed(1) : 0}%`);
}
/**
* 清除测试结果
*/
clearResults(): void {
this.results.clear();
}
}
/**
* 便捷函数:运行所有测试
*/
export async function runAllTests(): Promise<void> {
const runner = new TestRunner();
await runner.runAllTests();
}
/**
* 便捷函数:仅运行单元测试
*/
export async function runUnitTests(): Promise<void> {
const runner = new TestRunner();
await runner.runUnitTests();
}
/**
* 便捷函数:仅运行性能测试
*/
export async function runPerformanceTests(): Promise<void> {
const runner = new TestRunner();
await runner.runPerformanceTests();
}
// 如果直接运行此文件,执行所有测试
if (require.main === module) {
runAllTests().catch(console.error);
}