A / ENTRY
赛事入口说明
入口换过位置的时候，最怕收藏夹里那一条失效。这里给出三种读法：一页速览看结论，图文对照认位置，常见疑问处理旧链接。适合每天靠同一入口回访的老观众。
看本次调整的说明DOWNLOAD CENTER · 模板与文档
球队资料导出LEYU：模板、字段与格式一次选对
把球队档案、赛季战绩和对阵历史按你要的赛季和轮次取出来，连字段说明一起拿到手。格式怎么挑、列头怎么对、下载后先看哪一行，下面按实际使用场景排好了，看完就能直接动手。
01
内容目录：先认准你要的那一类
四类文档各管一段事——查入口、取资料、看变化、解故障。点下面的标签，只看你眼下用得上的那一类。
02
三类模板，对应三种用法
先想清楚拿这份文件做什么，再选模板，能省掉后面返工改列的时间。
01
球队档案
一支球队一行，基础信息横向铺开。适合先建一张底表，再往上面挂赛季数据；也适合社群做球队卡片时一次性取全。
- team_id
- team_name
- league_id
- home_city
- venue
02
赛季战绩
一场比赛一行，按赛季与轮次堆叠。适合做积分走势、主客场拆分、轮次速览卡片这类需要逐场比对的分析。
- season
- round
- home_score
- away_score
- points
03
对阵历史
两支球队之间的交手记录单列成表，按时间倒序。适合做赛前回顾、历史战绩对比，也可用作球迷社群的话题素材。
- match_id
- match_date
- home_team_id
- away_team_id
- result
本赛季战绩数据已更新至第 28 轮；每个比赛日赛后 30 分钟内更新比分与赛果，次日 10:00 前完成技术统计校对。历史数据按赛季、轮次、球队三个维度回溯，最早可追到 2016 赛季。
03
格式怎么选，字段怎么读
同一份数据有三种落法，选错了后面要多花时间改列。切换看看哪一种贴合你手上的工具。
| 适合谁 | 要用表格软件做筛选透视，或者写脚本批量读取的人 |
|---|---|
| 字符编码 | UTF-8 带 BOM，中文列头在表格软件里直接可读 |
| 字段命名 | 小写下划线，例如 team_id、season |
| 数值与日期 | 日期写成 YYYY-MM-DD，比分拆成主客两列，避免被当成日期解析 |
| 怎么打开 | 常见表格软件、脚本语言、数据看板均可直接导入 |
| 适合谁 | 要直接看表、画图、把文件转给同事一起看的人 |
|---|---|
| 工作表结构 | 每类模板一个工作表，字段组之间用空行分段 |
| 字段命名 | 首行中文列头，第二行附英文字段名，两种都能对着看 |
| 单元格格式 | 比分列预设为文本，打开后不会被自动改成日期 |
| 怎么打开 | 常见办公表格软件，手机端也能预览 |
| 适合谁 | 要接自家小程序、看板或写接口的人 |
|---|---|
| 结构 | 每条记录一个对象，字段按组嵌套，联动查询少拼字符串 |
| 字段命名 | 小写驼峰，与 CSV 的下划线写法一一对应 |
| 数值类型 | 比分与轮次为数字，时间为标准时间字符串，不做本地化转换 |
| 怎么打开 | 代码编辑器、接口调试工具、各类脚本运行环境 |
11 个字段组逐组说明
展开任意一组，看每个字段名对应的含义。字段名统一用等宽字体标出，右边一行是中文解释。
球队基础 team_*
- team_id
- 球队编号，全库唯一，跨模板通用
- team_name
- 球队全称，简体中文
- team_short
- 常用简称，适合放在图表标签上
联赛与赛区 league_*
- league_id
- 联赛编号，19 个频道各自唯一
- league_name
- 联赛名称，足球与篮球分列
- zone
- 赛区或分组，没有分组时留空
主场信息 venue_*
- home_city
- 球队所在城市
- venue
- 主场场馆名称，未登记时为空字符串
赛季归属 season*
- season
- 赛季标识，跨年赛季用起止年份表示
- stage
- 常规阶段或淘汰阶段
轮次范围 round*
- round
- 轮次序号，本赛季战绩已更新至第 28 轮
- round_total
- 该赛季总轮次数，用于算进度
赛果与比分 *_score
- home_score
- 主队得分，未开赛为空
- away_score
- 客队得分，未开赛为空
- result
- 主胜、客胜或平，篮球不出现平
对阵历史 match_*
- match_id
- 比赛编号，同一场比赛在各模板中一致
- match_date
- 比赛日期，格式 YYYY-MM-DD
技术统计 stat_*
- stat_key
- 统计项代码，如控球率、射门数
- stat_value
- 主客两侧的数值，随轮次逐场补齐
积分与排名 rank_*
- points
- 当前积分，随每轮赛果即时变化
- rank
- 联赛排名，同分时按净胜球排序
更新时间 updated_*
- updated_at
- 该行数据的最后更新时间，精确到分钟
- matchday
- 所属比赛日，方便按天切片
文档版本 doc_*
- doc_version
- 模板版本号，字段有调整时会递增
- doc_group
- 所属字段组，与本页折叠条目标题对应
04
三步拿到你要的那份文件
从选模板到确认列头，整个动作在一屏内完成。
STEP 01
挑模板
按你要做的分析选：建底表用球队档案，做走势用赛季战绩，看交手用对阵历史。
STEP 02
定范围
勾选赛季与轮次，默认带出本赛季第 28 轮，往前可一直取到 2016 赛季。
STEP 03
下载后先看首行
打开先确认第一行列头，再用更新时间字段比对一下是不是最新一版。
05
版本与更新记录
模板字段有过调整时，旧文件里的列可能对不上新说明。翻一下最近的记录，就知道手上那份要不要换。
-
4 月版本
导出模板新增积分与排名字段组
赛季战绩与对阵历史两个模板同时加入 points 与 rank。手上是旧模板的，重新取一份即可，原有列位置不变。
-
4 月版本
赛事入口变更说明上架
入口调整的说明整理成三种读法，已归到内容目录第一类，从首页可以直接进去。
-
上个比赛日
更新时间字段细化到分钟
新增 updated_at，配合比赛日字段，按天切片时不必再自己推算。
-
本季度
版本说明照常发布
入口、赛程排布与导出模板的变化一并记录，每季度一次，改动大的单独成条。
-
休赛期
文档与模板保持每周三次更新
赛季之外的节奏放慢但不停，字段注释与格式示例会跟着补充。
06
导出没成功，先看这三处
多数问题出在范围选得太大、编码选错或模板版本偏旧。展开对照一下，通常自己就能解决。
点了下载没反应，或者文件下到一半断掉
先换一个浏览器窗口重试一次；换了还断，把当前的网络环境记下来，再对照排查文档里「导出失败」那一类条目，逐条排除。范围只勾单赛季单模板时成功率最高。
文件能下，但打开是空的
多半是赛季与轮次两个条件交叉之后没有交集。把轮次范围放宽到整个赛季，或者只保留一个赛季再取一次，就能看到数据。
列头对不上，字段错位了
先看文件里的模板版本标记。4 月版本之后新增了积分与排名两个字段组，旧模板取出来的文件会缺这几列。重新取一份模板，按下方的字段说明对一遍列名即可。