简介：《周易排盘源码》是一套基于ASP语言开发的在线周易预测工具源码，面向易学爱好者、Web开发者以及希望研究传统术数算法实现的技术人员，可解决八字、六爻、奇门遁甲等排盘功能从零搭建的问题。资源以rar压缩包形式提供，整体约503KB，包内文件总数暂未获取到明细，主要围绕ASP页面与相关脚本组织，用于承载用户输入、干支转换、卦象生成与结果展示等核心逻辑。目前已有3201人学习下载，具备一定参考热度。源码中八字排盘涵盖生辰输入验证、干支转换、五行属性分析及大运流年推算；六爻排盘涉及摇卦模拟、卦象生成、动爻确定与爻辞引用；奇门遁甲则需处理时空坐标、洛书布局、九宫飞星及八门九星八神对应等复杂算法。对开发者而言，可借此理解ASP处理表单、数据计算与页面交互的完整流程；对易学研究者，则能获得一套可直接部署上线的在线排盘实践样本。
1. 周易排盘源码：从历法换算到卦象渲染，一套能跑通的工程化拆解
很多人第一次搜「周易排盘源码」，脑子里想的是找一份现成代码，复制粘贴就能出结果。真动手才发现，排盘不是查表，而是一条从公历时间到干支、从干支到卦象、从卦象到可视化输出的完整数据链路。公历转农历要处理闰月，干支纪日要处理节气分界，卦象还要区分本卦、变卦、互卦、错卦、综卦，每一步都有边界条件。我见过不少开发者卡在「为什么同一个生日，两个库排出来的日柱不一样」这种问题上，翻车点几乎全在历法精度和时区处理上。这篇笔记面向想自己实现排盘逻辑的后端或全栈工程师，也适合需要把排盘能力集成进小程序、App 或 Web 工具的从业者。下面按「数据从哪来、怎么算、怎么渲染、坑在哪」的顺序，把一套可复现的排盘源码结构讲清楚。
2. 排盘源码的四层架构：历法层、干支层、卦象层、渲染层
排盘系统看起来是一个功能，拆开其实是四层独立职责。分层的好处是每一层可以单独测试，出问题时能快速定位是历法算错了，还是卦象映射错了。我一般会把这四层写成四个模块，层与层之间只通过明确的数据结构传递，不互相耦合。
2.1 历法层：公历、农历、节气三套时间系统的换算
历法层是整个排盘的地基。输入通常是一个公历时间戳加时区，输出需要包含：农历年月日、是否闰月、当日节气、时辰地支。这里最容易出问题的是节气计算，因为干支纪月不是按农历月份切，而是按节气切。立春到惊蛰为寅月，惊蛰到清明为卯月，以此类推。
节气计算常见做法有两种：一种是查预生成的节气表，精度高但需要维护数据文件；另一种是用天文算法实时计算太阳黄经，代码量大但无需外部数据。对于排盘场景，我倾向于用预生成表加插值的方式，覆盖 1900 到 2100 年足够用，精度能到分钟级。
# 历法层核心数据结构 from dataclasses import dataclass from datetime import datetime @dataclass class LunarDate: year: int # 农历年 month: int # 农历月，闰月用负数表示，如 -6 表示闰六月 day: int # 农历日 is_leap: bool # 是否闰月 solar_term: str # 当日或最近节气名 hour_branch: str # 时辰地支，如 "子" def solar_to_lunar(dt: datetime, tz_offset: int = 8) -> LunarDate: """ 公历转农历，tz_offset 为时区偏移小时数，默认东八区。 内部依赖预生成的农历数据表，每年一个 16 进制编码。 """ # 1. 按 tz_offset 把 dt 归一到当地民用时 # 2. 查表得到该公历日期对应的农历年偏移 # 3. 处理闰月：闰月月份用负数标记，避免与正常月混淆 # 4. 计算时辰地支：23:00-01:00 为子时，注意晚子时归属次日 ...这段代码的关键参数是tz_offset。排盘必须固定时区，否则同一时刻在不同地区排出的时辰不同。常见做法是统一用东八区，但如果用户明确出生在其它时区，需要先转换再排。is_leap和负数月份的设计是为了让后续干支计算能正确区分闰月，很多开源实现在这里用布尔字段单独存，反而容易在跨年时出错。
2.2 干支层：年柱、月柱、日柱、时柱的推算规则
干支层接收历法层的输出，算出四柱。年柱以立春为界，不是正月初一；月柱以节气为界；日柱需要连续干支计数，通常用一个基准日的干支加天数差取模；时柱由日干和时辰地支共同决定，有固定的对照表。
日柱计算是最容易踩坑的地方。因为干支纪日是连续的，不受闰月、时区影响，但基准日选错一天，后面全错。我一般会选一个已知干支的日期作为锚点，比如 2000 年 1 月 1 日是戊午日，然后用(目标日期 - 锚点日期).days % 60得到偏移。
# 干支层：四柱推算 TIAN_GAN = "甲乙丙丁戊己庚辛壬癸" DI_ZHI = "子丑寅卯辰巳午未申酉戌亥" ANCHOR_DATE = datetime(2000, 1, 1) # 已知为戊午日 ANCHOR_INDEX = 54 # 戊午在六十甲子中的序号，从 0 开始 def get_day_pillar(dt: datetime) -> str: """计算日柱干支，返回如 '戊午'""" delta = (dt.date() - ANCHOR_DATE.date()).days idx = (ANCHOR_INDEX + delta) % 60 return TIAN_GAN[idx % 10] + DI_ZHI[idx % 12] def get_hour_pillar(day_gan: str, hour_branch: str) -> str: """ 时柱推算：日干决定时干起点。 甲己日起甲子，乙庚日起丙子，丙辛日起戊子， 丁壬日起庚子，戊癸日起壬子。 """ start_map = {"甲": 0, "己": 0, "乙": 2, "庚": 2, "丙": 4, "辛": 4, "丁": 6, "壬": 6, "戊": 8, "癸": 8} branch_idx = DI_ZHI.index(hour_branch) gan_idx = (start_map[day_gan] + branch_idx) % 10 return TIAN_GAN[gan_idx] + hour_branchANCHOR_INDEX这个参数必须校验。不同资料对六十甲子起始序号定义不同，有的从 1 开始，有的从 0 开始。我建议统一用 0 基，并且在单元测试里固定几个已知日期做回归。时柱的start_map是固定规则，但要注意晚子时问题：23 点之后出生，日柱算当天还是次日，不同流派有差异。工程上我一般提供配置项，默认按次日算，让用户可切换。
2.3 卦象层：从四柱到本卦、变卦、互卦的映射
卦象层是排盘区别于普通日历的核心。常见输入是四柱加一个起卦数，输出包含本卦、变卦、互卦、错卦、综卦，以及对应的六爻纳甲、六亲、世应。这一层的难点不在算法，而在规则多且流派差异大。
以梅花易数为例，起卦方式有按时间起、按数字起、按方位起。按时间起卦时，通常用年支数加月数加日数取上卦，加时辰数取下卦，总和取动爻。这里「年支数」是地支的序号，子为 1，丑为 2，不是干支组合的序号。
# 卦象层：梅花易数时间起卦 BAGUA = ["乾", "兑", "离", "震", "巽", "坎", "艮", "坤"] BAGUA_NUM = {"乾": 1, "兑": 2, "离": 3, "震": 4, "巽": 5, "坎": 6, "艮": 7, "坤": 8} def time_divination(year_branch_num: int, lunar_month: int, lunar_day: int, hour_branch_num: int): """ 时间起卦：上卦 = (年支数+月+日) % 8，余 0 取 8 下卦 = (年支数+月+日+时辰数) % 8，余 0 取 8 动爻 = (年支数+月+日+时辰数) % 6，余 0 取 6 """ upper = (year_branch_num + lunar_month + lunar_day) % 8 or 8 lower = (year_branch_num + lunar_month + lunar_day + hour_branch_num) % 8 or 8 moving = (year_branch_num + lunar_month + lunar_day + hour_branch_num) % 6 or 6 return { "upper": BAGUA[upper - 1], "lower": BAGUA[lower - 1], "moving_line": moving }参数说明：year_branch_num是地支序号，子为 1 到亥为 12；hour_branch_num同理。moving_line是动爻位置，从下往上数 1 到 6。得到上下卦和动爻后，还需要一张六十四卦对照表把上下卦组合映射成卦名，再根据动爻生成变卦。互卦取本卦的二三四爻为下卦、三四五爻为上卦，这一步用位运算实现最简洁。
2.4 渲染层：六爻排布、五行配色与输出格式
渲染层负责把卦象数据变成可展示的内容。如果是 Web 或小程序，通常输出 JSON 给前端；如果是命令行工具，输出文本表格。六爻排布要从下往上画，初爻在最下面，上爻在最上面，这个顺序不能反。
五行配色是常见需求：金用白色或金色，木用绿色，水用黑色或蓝色，火用红色，土用黄色。我一般把配色放在前端做，后端只输出五行属性，避免后端耦合展示逻辑。输出格式建议统一成嵌套 JSON，包含卦名、卦宫、六爻数组、每爻的干支五行六亲世应，前端拿到就能直接渲染。
3. 用 Python 跑通最小排盘：从输入生日到输出卦象
这一章给一个能直接跑的最小实现。不依赖第三方排盘库，只用标准库加一张农历数据表。目标是输入公历生日和时辰，输出四柱和本卦。代码分三段：历法换算、四柱推算、起卦输出。
3.1 准备农历数据表与节气表
农历数据表可以用常见的压缩编码：每年一个整数，用二进制位表示该年各月大小月和闰月位置。节气表用 24 个节气的公历日期偏移。为了控制篇幅，这里用简化版，只覆盖 1990 到 2030 年。
# 农历数据表：每年一个 16 进制数 # 低 4 位表示闰月月份，0 表示无闰月 # 中间 12 位表示各月大小，1 为大月 30 天，0 为小月 29 天 LUNAR_INFO = [ 0x04bd8, 0x04ae0, 0x0a570, 0x054d5, 0x0d260, # 1990-1994 0x0d950, 0x16554, 0x056a0, 0x09ad0, 0x055d2, # 1995-1999 0x04ae0, 0x0a5b6, 0x0a4d0, 0x0d250, 0x1d255, # 2000-2004 0x0b540, 0x0d6a0, 0x0ada2, 0x095b0, 0x14977, # 2005-2009 0x04970, 0x0a4b0, 0x0b4b5, 0x06a50, 0x06d40, # 2010-2014 0x1ab54, 0x02b60, 0x09570, 0x052f2, 0x04970, # 2015-2019 0x06566, 0x0d4a0, 0x0ea50, 0x06e95, 0x05ad0, # 2020-2024 0x02b60, 0x186e3, 0x092e0, 0x1c8d7, 0x0c950, # 2025-2029 0x0d4a0, 0x1d8a6, 0x0b550, 0x056a0, 0x1a5b4, # 2030-2034 ] def lunar_year_days(year: int) -> int: """计算农历某年总天数""" info = LUNAR_INFO[year - 1990] leap = info & 0xf total = 0 for i in range(12, 0, -1): total += 30 if (info >> i) & 1 else 29 if leap: total += 30 if (info >> 16) & 1 else 29 return totalLUNAR_INFO的索引从 1990 开始，使用时必须做范围校验。lunar_year_days里闰月天数用第 16 位判断，这个位在不同数据源里位置可能不同，移植时要核对。如果年份超出表范围，直接抛异常比返回错误结果好。
3.2 四柱推算的完整调用链
把历法层和干支层串起来，输入公历 datetime，输出四柱字符串。
def get_four_pillars(dt: datetime) -> dict: """输入公历时间，输出年月日时四柱""" lunar = solar_to_lunar(dt) year_gan_idx = (lunar.year - 4) % 10 year_zhi_idx = (lunar.year - 4) % 12 year_pillar = TIAN_GAN[year_gan_idx] + DI_ZHI[year_zhi_idx] # 月柱：由节气决定，这里简化用农历月映射 month_gan_idx = (year_gan_idx * 2 + lunar.month + 1) % 10 month_zhi_idx = (lunar.month + 1) % 12 month_pillar = TIAN_GAN[month_gan_idx] + DI_ZHI[month_zhi_idx] day_pillar = get_day_pillar(dt) hour_pillar = get_hour_pillar(day_pillar[0], lunar.hour_branch) return { "year": year_pillar, "month": month_pillar, "day": day_pillar, "hour": hour_pillar, "lunar": lunar }注意月柱这里做了简化，真实实现必须用节气分界。year_gan_idx用(year - 4) % 10是常见公式，但前提是年份按立春调整过。如果生日在立春前，农历年要减一。这个边界在测试时一定要覆盖，我一般会固定测 2 月 3 日和 2 月 5 日两个临界点。
3.3 起卦与输出 JSON 结构
拿到四柱后，用年支数、农历月日、时辰数起卦，输出结构化 JSON。
def build_divination_result(dt: datetime) -> dict: pillars = get_four_pillars(dt) lunar = pillars["lunar"] year_branch_num = DI_ZHI.index(pillars["year"][1]) + 1 hour_branch_num = DI_ZHI.index(lunar.hour_branch) + 1 gua = time_divination( year_branch_num=year_branch_num, lunar_month=abs(lunar.month), lunar_day=lunar.day, hour_branch_num=hour_branch_num ) return { "input": dt.isoformat(), "pillars": { "year": pillars["year"], "month": pillars["month"], "day": pillars["day"], "hour": pillars["hour"] }, "lunar": { "year": lunar.year, "month": lunar.month, "day": lunar.day, "is_leap": lunar.is_leap }, "hexagram": { "upper": gua["upper"], "lower": gua["lower"], "moving_line": gua["moving_line"], "name": lookup_hexagram(gua["upper"], gua["lower"]) } }lookup_hexagram需要一张六十四卦表，用上下卦名做键。输出 JSON 里保留原始输入和农历信息，方便排查。moving_line从 1 到 6，前端渲染时对应从下往上的爻位。
4. 排盘源码避坑：日柱错一天、闰月漏判断、时区没归一
这一章记录几个我实际踩过的坑，每条按现象、原因、解决写。排盘这类项目，算法本身不复杂，翻车基本都在边界和默认值上。
4.1 日柱整体偏移一天
现象：所有日柱都比预期多一天或少一天，年柱月柱正常。原因：锚点日期的干支记错，或者delta计算时用了datetime而不是date，导致时分秒参与运算产生小数天。解决：锚点日期用date对象，差值用.days，并且在单元测试里固定三个已知日期验证。我一般会写一个assert get_day_pillar(datetime(2000,1,1)) == "戊午"作为回归基线。
4.2 闰月导致月柱和卦象全错
现象：闰月出生的用户，农历月份显示正常，但月柱和起卦结果和预期不符。原因：闰月在数据表里用负数或单独字段表示，但后续计算直接用了绝对值，丢失了闰月信息。解决：在LunarDate里同时保留month和is_leap，所有需要月份的地方显式判断。起卦时如果流派要求闰月按本月算，就取绝对值；如果要求按下一月算，就加一。这个规则要写成配置，不要硬编码。
4.3 时区没归一导致时辰跨日
现象：用户输入北京时间 23:30，排出来的日柱是当天，但用户认为应该算次日。原因：晚子时归属规则不统一，且代码里没有把输入时间归一到目标时区。解决：在入口处统一转成东八区，再判断小时数。23 点之后提供late_zi_next_day配置，默认True。如果用户在其他时区，先转 UTC 再转东八区，不要直接加偏移。
4.4 节气表精度不够导致月柱临界错误
现象：生日刚好在节气当天，月柱和预期差一个月。原因：节气表只精确到日，没有精确到小时。解决：节气表至少精确到小时，或者用天文算法实时算。如果做不到，在节气当天给出提示，让用户确认具体出生时间。我一般会在输出里加一个near_solar_term标记，提醒前端展示注意事项。
4.5 六十四卦映射表上下卦顺序写反
现象：卦名和上下卦对不上，比如上乾下坤输出成泰卦。原因：查表时键的顺序和表定义不一致。解决：统一用(upper, lower)元组做键，并且在表定义处加注释。测试时覆盖八个纯卦和几个典型组合，比如天地否、地天泰。
5. 进阶：把排盘源码做成可验证、可扩展的模块
排盘源码写到能跑不难，难的是让它可验证、可扩展。我现在的习惯是每个模块配一组固定用例，历法层测闰月和节气边界，干支层测锚点和跨年，卦象层测动爻和变卦。用例数据单独放一个 JSON 文件，不写在代码里，方便非开发者核对。
扩展方向上，最常见的是加纳甲和六亲。纳甲规则是固定的：乾纳甲壬，坤纳乙癸，震纳庚，巽纳辛，坎纳戊，离纳己，艮纳丙，兑纳丁。六亲由卦宫五行和爻的五行生克决定。这部分建议单独一个模块，输入卦象输出六爻详情，不要和起卦逻辑混在一起。
另一个扩展点是支持多种起卦方式。时间起卦只是其中一种，还有数字起卦、报数起卦、方位起卦。我一般定义一个DivinationMethod接口，每种方式实现cast(input) -> Hexagram，上层只依赖接口。这样加新方式不用改渲染层。
验证方法上，除了单元测试，我还会做交叉验证：用两套独立实现的历法库排同一批日期，对比四柱。如果结果不一致，优先查节气边界和时区。这个方法帮我抓到过好几次闰月判断的 bug。
最后说一个我自己的教训：早期为了赶进度，把农历数据表和节气表硬编码在业务代码里，后来要扩展到 2100 年，改起来非常痛苦。现在我会把数据表单独放一个模块，加版本号和校验和，业务代码只调用接口。排盘这种项目，数据比算法更容易过期，把数据层独立出来，后面省很多后悔药。希望帮到你。
本文还有配套的精品资源，点击获取
