From 2d6bfde31c0b50b460f89f20d06941b46e79aef5 Mon Sep 17 00:00:00 2001 From: class04f04 Date: Thu, 24 Sep 2026 03:33:48 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E5=96=84=20README=EF=BC=8C?= =?UTF-8?q?=E8=AF=B4=E6=98=8E=20BMI/BMR/PAL/TDEE=20=E7=AE=97=E6=B3=95?= =?UTF-8?q?=E4=B8=8E=E4=BD=BF=E7=94=A8=E6=96=B9=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 107 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 106 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index c923373..8ea5440 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,108 @@ # daily-calorie-calculator -每日热量需求计算器:按性别/年龄/身高/体重与日常活动量估算 BMI、BMR、PAL 与 TDEE,给出维持/减脂/增重每日建议摄入热量(网页版 + 命令行版) \ No newline at end of file +每日热量需求计算器:根据**性别 / 年龄 / 身高 / 体重 / 日常活动量**估算 BMI、BMR、PAL 与 TDEE, +并给出「维持 / 减脂 / 增重」三种目标的每日建议摄入热量。 + +## 文件说明 + +| 文件 | 说明 | +| --- | --- | +| `index.html` | 网页版计算器(纯 HTML + CSS + 原生 JS,单文件,双击即可使用,无需联网或安装依赖) | +| `calorie_calculator.py` | 命令行版计算器(Python 3,无第三方依赖) | + +## 算法(这是回答「一天需要摄入多少热量」的完整推算过程) + +### 第 1 步:BMI(身体质量指数) + +``` +BMI = 体重(kg) / 身高(m)² +``` + +分级采用**中国成人标准**: + +| BMI 区间 | 判定 | +| --- | --- | +| < 18.5 | 偏瘦 | +| 18.5 – 23.9 | 正常 | +| 24.0 – 27.9 | 超重 | +| ≥ 28.0 | 肥胖 | + +> 注:世界卫生组织的正常上限是 25,中国标准更严格(24),本工具采用中国标准。 + +### 第 2 步:BMR(基础代谢率),Mifflin-St Jeor 公式 + +``` +男性:BMR = 10 × 体重(kg) + 6.25 × 身高(cm) − 5 × 年龄 + 5 +女性:BMR = 10 × 体重(kg) + 6.25 × 身高(cm) − 5 × 年龄 − 161 +``` + +这是目前公认对普通人群估算最准的公式之一,比旧的 Harris-Benedict 公式更贴近现代人体型。 + +### 第 3 步:PAL(日常活动系数) + +| 活动量 | PAL | +| --- | --- | +| 几乎没有 / 久坐(基本不运动,以坐为主) | 1.2 | +| 轻度活动(每周 1–3 次轻量运动或经常散步) | 1.375 | +| 中度活动(每周 3–5 次中等强度运动) | 1.55 | +| 高度活动(每周 6–7 次高强度运动) | 1.725 | +| 极高活动(体力劳动或一天两练) | 1.9 | + +### 第 4 步:TDEE(每日总能量消耗)= 维持当前体重所需热量 + +``` +TDEE = BMR × PAL +``` + +### 第 5 步:按目标给出建议摄入量 + +``` +增重 = TDEE + 300 kcal/天 +维持 = TDEE kcal/天 +减脂 = TDEE − 400 kcal/天 +``` + +- 每天多吃约 300 kcal ≈ 每周增重 0.25–0.3 kg(增重时建议配合力量训练,保证蛋白质)。 +- 每天少吃约 400 kcal ≈ 每周减重 0.35–0.4 kg,属于较安全的减脂速度。 + +### 其他参考值 + +- 蛋白质:约 1.2 g/kg 体重/天 +- 饮水:约 30 ml/kg 体重/天 + +## 使用方式 + +### 网页版 + +直接用浏览器打开 `index.html`,填写性别、年龄、身高、体重,选择活动量,点击「计算」。 + +### 命令行版 + +```bash +python3 calorie_calculator.py +``` + +按提示输入即可,例如: + +``` +性别(男/女,默认女):女 +年龄(岁):25 +身高(cm):160 +体重(kg):48 +日常活动量: + 1. 几乎没有 / 久坐(基本不运动,以坐为主) + ... +请选择活动量编号(默认 1:几乎没有):1 +``` + +## 计算示例 + +以「女、25 岁、160 cm、48 kg、几乎没有活动」为例: + +1. BMI = 48 / 1.60² = **18.8** → 正常(但贴近偏瘦边缘) +2. BMR = 10×48 + 6.25×160 − 5×25 − 161 = **1,194 kcal** +3. PAL = 1.2 +4. TDEE = 1194 × 1.2 = **1,433 kcal** ← 维持体重所需 +5. 建议(BMI 贴近偏瘦边缘):按 **1,433 ~ 1,733 kcal/天** 摄入,避免继续掉秤 + +> 以上为估算值,个体误差约 ±10%。若患有疾病或处于特殊生理阶段,请咨询医生或注册营养师。