简介这是一份用 Haskell 实现有限域算术的库资源面向学习抽象代数、密码学与函数式编程的开发者尤其适合需要在代码中落地素域与伽罗瓦域运算的中高级读者。包内共 33 个文件以 23 个 hs 源码为主体辅以 cabal 构建配置、ghci 交互脚本、C 与头文件、测试套件及说明文档压缩包约 275KB结构紧凑。目前已实现通用素数字段、p 小于 2^31 的小素数字段以及基于 Conway 多项式预计算表和 Zech 对数表的小型伽罗瓦域并附带 Zech 对数函数的 C 实现。读者可借此理解有限域运算的模块划分与类型设计参考测试用例验证正确性并沿作者规划的通用域扩展、密码学大域、椭圆曲线等方向继续实践。已有 166 人学习下载。1. 有限域算术到底能拿来干什么从 Haskell 的finite-fields说起如果你写过 AES、Reed-Solomon 纠错、椭圆曲线签名或者只是想在 Haskell 里做一次GF(2^8)上的多项式乘法你大概率绕不开一个东西有限域。它不是什么玄学本质就是「元素个数有限、加减乘除都封闭」的代数结构。finite-fields这个 Haskell 包干的就是把这件事从数学定义变成你能直接import的类型和函数。我第一次接触它是因为一个二维码纠错的项目当时手写GF(256)乘法表写到怀疑人生后来发现这个包已经把域扩张、多项式、逆元全给你封好了。它适合谁适合已经会写 Haskell、但不想在代数细节上反复翻车的工程师也适合想拿有限域当练手项目、顺便把类型系统用起来的人。这一章先把「它是什么、能解决什么」讲清楚后面几章再落到具体怎么用、参数怎么设、坑在哪。2. 有限域的类型抽象为什么GF p比手写模运算靠谱2.1 从整数模 p 到域扩张的建模思路有限域分两类素数域GF(p)和扩域GF(p^n)。finite-fields的做法不是给你一堆裸函数而是用类型把「域」这件事编码进去。常见做法是定义一个Field类型类把add、mul、neg、inv这些运算抽象出来然后GF p作为素数域的实例扩域则通过不可约多项式构造。这样写的好处是编译器能帮你检查你是不是把两个不同域的元素混在一起算了——这在手写代码里是高频错误两个Int相乘你根本不知道它属于哪个域。我一般会先确认自己要的是素数域还是扩域。如果只是做模素数运算GF p就够了如果要做 AES 那种GF(2^8)就得走扩域路径指定不可约多项式。这个包的设计让你在类型层面就把「域」固定下来而不是靠注释和约定。2.2 用 GHCi 验证基本运算先装包再进 GHCi 做最小验证。下面这段是常见做法cabal update cabal install finite-fields ghci进 GHCi 后加载模块并试几个运算-- 引入有限域模块 import Data.Field.Galois -- 在 GF(7) 上做加法和乘法 -- 7 是素数GF 7 是合法素数域 let a 3 :: GF 7 let b 5 :: GF 7 -- 加法3 5 8模 7 得 1 a b -- 结果应为 1 -- 乘法3 * 5 15模 7 得 1 a * b -- 结果应为 1 -- 求逆5 在 GF(7) 下的逆元是 3因为 5*315≡1 inv b -- 结果应为 3逻辑说明GF 7里的7是类型级自然数编译期就确定域的大小。a b不是普通整数加法而是域内加法结果自动约减。参数说明GF p的p必须是素数如果你写GF 6类型检查可能过但运算语义就错了——这是第一个要记住的边界。inv对零元素会报错或返回未定义实际用之前要自己判零。2.3 扩域构造与不可约多项式的选择扩域GF(p^n)的构造依赖一个在GF(p)上不可约的n次多项式。常见做法是包提供GF的扩域形式你通过类型或值指定多项式。以GF(2^8)为例AES 用的是x^8 x^4 x^3 x 1对应十六进制0x11B。如果你选错多项式得到的域结构就变了乘法和逆元结果全不对。-- 构造 GF(2^8)指定不可约多项式 -- 这里用类型级或运行时参数指定多项式系数 -- 具体 API 以包文档为准常见形式如下 let x 0x57 :: GF 256 let y 0x83 :: GF 256 x * y -- 结果取决于所选不可约多项式参数说明不可约多项式必须是真正不可约的否则你构造出来的不是域逆元可能不存在。验证方法对域内所有非零元素求逆看是否都能得到合法结果。这一步很多人跳过后面做纠错码时才发现逆元算错排查成本极高。3. 多项式与逆元有限域里最容易翻车的两块3.1 多项式运算的实现与边界有限域上的多项式运算和普通多项式类似但系数运算在域内进行。finite-fields通常提供多项式类型或让你用列表表示系数。常见做法是用系数列表从高次到低次或反之具体顺序要看包约定搞反了结果全错。-- 用系数列表表示多项式假设从高次到低次 -- 多项式 x^2 2x 3 在 GF(7) 上 let p1 [1, 2, 3] :: [GF 7] -- 多项式 x 1 let p2 [1, 1] :: [GF 7] -- 多项式加法对应系数相加 -- 结果应为 x^2 3x 4 addPoly p1 p2 -- 多项式乘法卷积后系数在域内约减 mulPoly p1 p2逻辑说明多项式加法就是逐系数域内加法乘法是卷积再约减。参数说明系数列表的长度和顺序必须一致否则加法会错位。如果你用的是包内置的多项式类型注意它的Num实例是否按域运算实现——有些包直接复用整数运算那就不是域上多项式了。3.2 扩展欧几里得求逆元的实操求逆元最稳的方法是扩展欧几里得算法在多项式环上做。手写一遍能帮你理解为什么某些元素没有逆元。-- 扩展欧几里得求 GF(p) 上 a 的逆元 -- 返回 (g, x, y) 使得 a*x p*y g egcd :: Integer - Integer - (Integer, Integer, Integer) egcd a 0 (a, 1, 0) egcd a b let (g, x, y) egcd b (a mod b) in (g, y, x - (a div b) * y) -- 求 a 在模 p 下的逆元 invMod :: Integer - Integer - Integer invMod a p let (g, x, _) egcd a p in if g / 1 then error 逆元不存在a 和 p 不互素 else x mod p逻辑说明egcd递归到余数为零回溯时更新系数。invMod检查最大公约数是否为 1不是 1 就说明逆元不存在。参数说明a和p必须互素在素数域里只要a不是p的倍数就满足。这个实现用Integer实际项目里可以换成域元素类型但逻辑一样。3.3 用 QuickCheck 验证域公理写完运算后别急着上业务代码先用属性测试验证域公理。常见做法是用 QuickCheck 生成随机元素检查加法交换律、乘法结合律、分配律、逆元性质。-- 用 QuickCheck 验证 GF(7) 上的乘法交换律 import Test.QuickCheck prop_mulComm :: GF 7 - GF 7 - Bool prop_mulComm a b a * b b * a -- 验证非零元素都有逆元 prop_invExists :: GF 7 - Property prop_invExists a a / 0 a * inv a 1逻辑说明是条件蕴含只在a / 0时检查。参数说明GF 7需要是Arbitrary实例包一般会提供没有就自己写生成器。这一步能提前抓出多项式选错、约减逻辑错误等问题比等到业务层报错再回头查省事得多。4. 避坑与排查有限域实现里那些血泪经验4.1 不可约多项式选错导致逆元全错现象所有非零元素求逆后乘回去不等于 1或者部分元素直接报「逆元不存在」。原因扩域构造时用的多项式在基域上可约构造出来的不是域而是环。解决换用已知不可约多项式比如GF(2^8)用0x11BGF(2^4)用x^4 x 1。验证方法是对所有非零元素求逆并检查乘积。4.2 类型级自然数写错导致域大小不对现象GF 6这种非素数域编译能过但运算结果不符合预期。原因类型级自然数没有强制素数检查GF 6在语义上不是域。解决自己封装智能构造器或者用包提供的素数域构造方式确保p是素数。常见做法是在测试里加一条属性对GF p的所有非零元素逆元存在。4.3 多项式系数顺序搞反现象多项式乘法结果和手算对不上但加法正常。原因系数列表顺序约定和包不一致乘法卷积时高低次错位。解决先写一个已知结果的小例子验证顺序比如(x 1) * (x 1) x^2 2x 1在GF(7)上2不约减直接看系数位置。4.4 零元素求逆没有提前判现象运行时抛异常或返回垃圾值。原因零元素在域里没有逆元但代码没判零。解决在调用inv前显式检查或者用Maybe包装返回类型。常见做法是写一个safeInv :: GF p - Maybe (GF p)零返回Nothing。4.5 性能问题每次运算都重新构造域现象大批量运算时速度慢得离谱。原因每次运算都重新计算不可约多项式或重新构造域结构。解决把域结构提出来复用或者用类型级固定域让编译器优化。如果包支持用let绑定域参数避免重复构造。5. 进阶技巧把有限域运算压进类型系统5.1 用类型级编程固定域参数finite-fields的一个亮点是能把域大小和不可约多项式提到类型层。这样编译器能在编译期检查域是否匹配运行时零开销。常见做法是用DataKinds和TypeApplications{-# LANGUAGE DataKinds #-} {-# LANGUAGE TypeApplications #-} import Data.Field.Galois -- 在类型层指定 GF(7) let a 3 :: GF 7 let b 5 :: GF 7 -- 用类型应用显式指定 -- 这样写能避免歧义尤其在 GHCi 里 let c (*) (GF 7) a b逻辑说明GF 7里的7是类型级自然数(GF 7)是类型应用告诉编译器用哪个实例。参数说明需要开启DataKinds和TypeApplications扩展。这样写的好处是域参数不会在运行时丢失也不会因为默认推导选错实例。5.2 用newtype包装防止域混用如果你同时用多个域比如GF(2^8)和GF(2^16)裸类型容易混。常见做法是用newtype给每个域一个独立类型newtype AESField AESField (GF 256) deriving (Eq, Show) newtype RSField RSField (GF 256) deriving (Eq, Show) -- 两个域的运算不能直接混 -- 编译器会报类型错误逻辑说明newtype是零开销包装运行时和裸类型一样。参数说明需要手动实现Num等实例或者用deriving加扩展。这样能防止你把 AES 域的元素和 RS 域的元素相加虽然底层都是GF 256但语义不同。5.3 验证方法用已知测试向量对拍最后一步拿已知测试向量验证你的实现。比如 AES 的 S-box 输入0x57逆元是0x83乘回去应该是1。或者用 Reed-Solomon 的标准测试向量。常见做法是写一组hspec测试import Test.Hspec main :: IO () main hspec $ do describe GF(2^8) AES 域 $ do it 0x57 的逆元是 0x83 $ do let x 0x57 :: GF 256 let y 0x83 :: GF 256 x * y shouldBe 1逻辑说明shouldBe检查相等。参数说明GF 256需要配置成 AES 用的不可约多项式0x11B否则这个测试会失败。这一步是最后的后悔药如果测试不过回头查多项式选择和系数顺序。从那以后我每次用有限域都强制先跑一遍域公理测试和已知向量对拍再写业务代码。希望帮到你。本文还有配套的精品资源点击获取
简介这是一份用 Haskell 实现有限域算术的库资源面向学习抽象代数、密码学与函数式编程的开发者尤其适合需要在代码中落地素域与伽罗瓦域运算的中高级读者。包内共 33 个文件以 23 个 hs 源码为主体辅以 cabal 构建配置、ghci 交互脚本、C 与头文件、测试套件及说明文档压缩包约 275KB结构紧凑。目前已实现通用素数字段、p 小于 2^31 的小素数字段以及基于 Conway 多项式预计算表和 Zech 对数表的小型伽罗瓦域并附带 Zech 对数函数的 C 实现。读者可借此理解有限域运算的模块划分与类型设计参考测试用例验证正确性并沿作者规划的通用域扩展、密码学大域、椭圆曲线等方向继续实践。已有 166 人学习下载。1. 有限域算术到底能拿来干什么从 Haskell 的finite-fields说起如果你写过 AES、Reed-Solomon 纠错、椭圆曲线签名或者只是想在 Haskell 里做一次GF(2^8)上的多项式乘法你大概率绕不开一个东西有限域。它不是什么玄学本质就是「元素个数有限、加减乘除都封闭」的代数结构。finite-fields这个 Haskell 包干的就是把这件事从数学定义变成你能直接import的类型和函数。我第一次接触它是因为一个二维码纠错的项目当时手写GF(256)乘法表写到怀疑人生后来发现这个包已经把域扩张、多项式、逆元全给你封好了。它适合谁适合已经会写 Haskell、但不想在代数细节上反复翻车的工程师也适合想拿有限域当练手项目、顺便把类型系统用起来的人。这一章先把「它是什么、能解决什么」讲清楚后面几章再落到具体怎么用、参数怎么设、坑在哪。2. 有限域的类型抽象为什么GF p比手写模运算靠谱2.1 从整数模 p 到域扩张的建模思路有限域分两类素数域GF(p)和扩域GF(p^n)。finite-fields的做法不是给你一堆裸函数而是用类型把「域」这件事编码进去。常见做法是定义一个Field类型类把add、mul、neg、inv这些运算抽象出来然后GF p作为素数域的实例扩域则通过不可约多项式构造。这样写的好处是编译器能帮你检查你是不是把两个不同域的元素混在一起算了——这在手写代码里是高频错误两个Int相乘你根本不知道它属于哪个域。我一般会先确认自己要的是素数域还是扩域。如果只是做模素数运算GF p就够了如果要做 AES 那种GF(2^8)就得走扩域路径指定不可约多项式。这个包的设计让你在类型层面就把「域」固定下来而不是靠注释和约定。2.2 用 GHCi 验证基本运算先装包再进 GHCi 做最小验证。下面这段是常见做法cabal update cabal install finite-fields ghci进 GHCi 后加载模块并试几个运算-- 引入有限域模块 import Data.Field.Galois -- 在 GF(7) 上做加法和乘法 -- 7 是素数GF 7 是合法素数域 let a 3 :: GF 7 let b 5 :: GF 7 -- 加法3 5 8模 7 得 1 a b -- 结果应为 1 -- 乘法3 * 5 15模 7 得 1 a * b -- 结果应为 1 -- 求逆5 在 GF(7) 下的逆元是 3因为 5*315≡1 inv b -- 结果应为 3逻辑说明GF 7里的7是类型级自然数编译期就确定域的大小。a b不是普通整数加法而是域内加法结果自动约减。参数说明GF p的p必须是素数如果你写GF 6类型检查可能过但运算语义就错了——这是第一个要记住的边界。inv对零元素会报错或返回未定义实际用之前要自己判零。2.3 扩域构造与不可约多项式的选择扩域GF(p^n)的构造依赖一个在GF(p)上不可约的n次多项式。常见做法是包提供GF的扩域形式你通过类型或值指定多项式。以GF(2^8)为例AES 用的是x^8 x^4 x^3 x 1对应十六进制0x11B。如果你选错多项式得到的域结构就变了乘法和逆元结果全不对。-- 构造 GF(2^8)指定不可约多项式 -- 这里用类型级或运行时参数指定多项式系数 -- 具体 API 以包文档为准常见形式如下 let x 0x57 :: GF 256 let y 0x83 :: GF 256 x * y -- 结果取决于所选不可约多项式参数说明不可约多项式必须是真正不可约的否则你构造出来的不是域逆元可能不存在。验证方法对域内所有非零元素求逆看是否都能得到合法结果。这一步很多人跳过后面做纠错码时才发现逆元算错排查成本极高。3. 多项式与逆元有限域里最容易翻车的两块3.1 多项式运算的实现与边界有限域上的多项式运算和普通多项式类似但系数运算在域内进行。finite-fields通常提供多项式类型或让你用列表表示系数。常见做法是用系数列表从高次到低次或反之具体顺序要看包约定搞反了结果全错。-- 用系数列表表示多项式假设从高次到低次 -- 多项式 x^2 2x 3 在 GF(7) 上 let p1 [1, 2, 3] :: [GF 7] -- 多项式 x 1 let p2 [1, 1] :: [GF 7] -- 多项式加法对应系数相加 -- 结果应为 x^2 3x 4 addPoly p1 p2 -- 多项式乘法卷积后系数在域内约减 mulPoly p1 p2逻辑说明多项式加法就是逐系数域内加法乘法是卷积再约减。参数说明系数列表的长度和顺序必须一致否则加法会错位。如果你用的是包内置的多项式类型注意它的Num实例是否按域运算实现——有些包直接复用整数运算那就不是域上多项式了。3.2 扩展欧几里得求逆元的实操求逆元最稳的方法是扩展欧几里得算法在多项式环上做。手写一遍能帮你理解为什么某些元素没有逆元。-- 扩展欧几里得求 GF(p) 上 a 的逆元 -- 返回 (g, x, y) 使得 a*x p*y g egcd :: Integer - Integer - (Integer, Integer, Integer) egcd a 0 (a, 1, 0) egcd a b let (g, x, y) egcd b (a mod b) in (g, y, x - (a div b) * y) -- 求 a 在模 p 下的逆元 invMod :: Integer - Integer - Integer invMod a p let (g, x, _) egcd a p in if g / 1 then error 逆元不存在a 和 p 不互素 else x mod p逻辑说明egcd递归到余数为零回溯时更新系数。invMod检查最大公约数是否为 1不是 1 就说明逆元不存在。参数说明a和p必须互素在素数域里只要a不是p的倍数就满足。这个实现用Integer实际项目里可以换成域元素类型但逻辑一样。3.3 用 QuickCheck 验证域公理写完运算后别急着上业务代码先用属性测试验证域公理。常见做法是用 QuickCheck 生成随机元素检查加法交换律、乘法结合律、分配律、逆元性质。-- 用 QuickCheck 验证 GF(7) 上的乘法交换律 import Test.QuickCheck prop_mulComm :: GF 7 - GF 7 - Bool prop_mulComm a b a * b b * a -- 验证非零元素都有逆元 prop_invExists :: GF 7 - Property prop_invExists a a / 0 a * inv a 1逻辑说明是条件蕴含只在a / 0时检查。参数说明GF 7需要是Arbitrary实例包一般会提供没有就自己写生成器。这一步能提前抓出多项式选错、约减逻辑错误等问题比等到业务层报错再回头查省事得多。4. 避坑与排查有限域实现里那些血泪经验4.1 不可约多项式选错导致逆元全错现象所有非零元素求逆后乘回去不等于 1或者部分元素直接报「逆元不存在」。原因扩域构造时用的多项式在基域上可约构造出来的不是域而是环。解决换用已知不可约多项式比如GF(2^8)用0x11BGF(2^4)用x^4 x 1。验证方法是对所有非零元素求逆并检查乘积。4.2 类型级自然数写错导致域大小不对现象GF 6这种非素数域编译能过但运算结果不符合预期。原因类型级自然数没有强制素数检查GF 6在语义上不是域。解决自己封装智能构造器或者用包提供的素数域构造方式确保p是素数。常见做法是在测试里加一条属性对GF p的所有非零元素逆元存在。4.3 多项式系数顺序搞反现象多项式乘法结果和手算对不上但加法正常。原因系数列表顺序约定和包不一致乘法卷积时高低次错位。解决先写一个已知结果的小例子验证顺序比如(x 1) * (x 1) x^2 2x 1在GF(7)上2不约减直接看系数位置。4.4 零元素求逆没有提前判现象运行时抛异常或返回垃圾值。原因零元素在域里没有逆元但代码没判零。解决在调用inv前显式检查或者用Maybe包装返回类型。常见做法是写一个safeInv :: GF p - Maybe (GF p)零返回Nothing。4.5 性能问题每次运算都重新构造域现象大批量运算时速度慢得离谱。原因每次运算都重新计算不可约多项式或重新构造域结构。解决把域结构提出来复用或者用类型级固定域让编译器优化。如果包支持用let绑定域参数避免重复构造。5. 进阶技巧把有限域运算压进类型系统5.1 用类型级编程固定域参数finite-fields的一个亮点是能把域大小和不可约多项式提到类型层。这样编译器能在编译期检查域是否匹配运行时零开销。常见做法是用DataKinds和TypeApplications{-# LANGUAGE DataKinds #-} {-# LANGUAGE TypeApplications #-} import Data.Field.Galois -- 在类型层指定 GF(7) let a 3 :: GF 7 let b 5 :: GF 7 -- 用类型应用显式指定 -- 这样写能避免歧义尤其在 GHCi 里 let c (*) (GF 7) a b逻辑说明GF 7里的7是类型级自然数(GF 7)是类型应用告诉编译器用哪个实例。参数说明需要开启DataKinds和TypeApplications扩展。这样写的好处是域参数不会在运行时丢失也不会因为默认推导选错实例。5.2 用newtype包装防止域混用如果你同时用多个域比如GF(2^8)和GF(2^16)裸类型容易混。常见做法是用newtype给每个域一个独立类型newtype AESField AESField (GF 256) deriving (Eq, Show) newtype RSField RSField (GF 256) deriving (Eq, Show) -- 两个域的运算不能直接混 -- 编译器会报类型错误逻辑说明newtype是零开销包装运行时和裸类型一样。参数说明需要手动实现Num等实例或者用deriving加扩展。这样能防止你把 AES 域的元素和 RS 域的元素相加虽然底层都是GF 256但语义不同。5.3 验证方法用已知测试向量对拍最后一步拿已知测试向量验证你的实现。比如 AES 的 S-box 输入0x57逆元是0x83乘回去应该是1。或者用 Reed-Solomon 的标准测试向量。常见做法是写一组hspec测试import Test.Hspec main :: IO () main hspec $ do describe GF(2^8) AES 域 $ do it 0x57 的逆元是 0x83 $ do let x 0x57 :: GF 256 let y 0x83 :: GF 256 x * y shouldBe 1逻辑说明shouldBe检查相等。参数说明GF 256需要配置成 AES 用的不可约多项式0x11B否则这个测试会失败。这一步是最后的后悔药如果测试不过回头查多项式选择和系数顺序。从那以后我每次用有限域都强制先跑一遍域公理测试和已知向量对拍再写业务代码。希望帮到你。本文还有配套的精品资源点击获取
