nba_data

最新的 NBA 数据包

data/

在 data 目录中，所有赛季的标识均代表该赛季的结束时间，因此 2025 即指 2024-25 NBA 赛季。data 目录中存放有从 2009-10 赛季到当前赛季的数据

• gamelog_<season>.parquet：指定赛季中各球队的比赛记录
• gamelogs.parquet：所有赛季中各球队的比赛记录
• metadata.json：最近一次更新的日期
• playerlog_<season>.parquet：每位球员的比赛记录
• player_game_logs.parquet：所有赛季中每位球员的比赛记录
• players_<season>.parquet：整个赛季的球员数据
• players_<season>_playoffs.parquet：整个季后赛阶段的球员数据
• playerstats.parquet：所有已收录赛季中每赛季的球员数据
• playerstats_playoffs.parquet：所有已收录赛季中每个季后赛赛季的球员数据
• team_efficiency_<season>.json：球队效率统计数据
• team_summary_<season>.json：指定赛季的球队综合统计数据
• team_summary.json：所有赛季的球队综合统计数据

data/espn

从 espnanalytics.com] 收集的数据。涵盖范围从 2018-19 赛季到当前赛季。

注意：在此目录中，赛季名称代表的是该赛季的_第一年_，而非最后一年。对于这种不一致之处我们深表歉意。

注意更新：截至 2026 年 2 月 24 日，这一规则已不再适用。如果您正在使用这些数据，需要相应调整您的使用方式。对于由此带来的不便，我们致以歉意，也对我之前犯下的错误感到遗憾。

• four_factors.parquet：每场比赛的四大核心数据
• player_box.parquet：每场比赛的球员个人数据统计
• player_details.parquet：更详细的球员个人数据统计
• team_box.parquet：每场比赛的球队整体数据统计

src

用于更新数据的源代码。有关运行方法，请参阅 makefile 文件

NBA 比赛 ID 前缀

前缀	比赛类型	示例
001	赛前训练赛	0012500068 - 10月2日至17日的比赛
002	正常赛季	0022400123 - 正赛赛季的比赛
003	全明星赛	0032400001 - 全明星周末的比赛
004	季后赛	0042400101 - 季后赛比赛（包含轮次/系列/场次编码）
005	外卡赛	0052400101 - 外卡赛比赛
006	NBA杯赛（赛季内锦标赛）决赛	0062500001 - NBA杯冠军赛

完整的比赛ID格式为：00X YYZZ GGGG，其中：

• 00X = 比赛类型前缀
• YY = 赛季年份（24代表2024-25赛季）
• ZZ + GGGG = 该场比赛的专属标识符（因比赛类型而异） |