中国身份证号验证库

id-validator - Go 版中国身份证号验证库。

功能

• 中国身份证号验证
• 获取身份证号信息
• 升级 15 位身份证号为 18 位
• 伪造符合校验的身份证号

安装

$ go get -u github.com/guanguans/id-validator

使用

这只是一个快速介绍, 请查看 GoDoc 获得详细信息。

package main

import (
    idvalidator "github.com/guanguans/id-validator"
    "gopkg.in/ffmt.v1"
)

func main() {
    // 验证身份证号合法性
    ffmt.P(idvalidator.IsValid("440308199901101512"))  // 大陆居民身份证18位
    ffmt.P(idvalidator.IsValid("610104620927690"))     // 大陆居民身份证15位
    ffmt.P(idvalidator.IsValid("810000199408230021"))  // 港澳居民居住证18位
    ffmt.P(idvalidator.IsValid("830000199201300022"))  // 台湾居民居住证18位

    // 获取身份证号信息
    ffmt.P(idvalidator.GetInfo("440308199901101512"))
    // []interface {}[
    //  github.com/guanguans/id-validator.IdInfo{          // 身份证号信息
    //      AddressCode: int(440308)                           // 地址码
    //      Abandoned:   int(0)                                // 地址码是否废弃：1为废弃的，0为正在使用的
    //      Address:     string("广东省深圳市盐田区")             // 地址
    //      AddressTree: []string[                             // 省市区三级列表
    //          string("广东省")                                    // 省
    //          string("深圳市")                                    // 市
    //          string("盐田区")                                    // 区
    //      ]
    //      Birthday:      <1999-01-10 00:00:00 +0000 UTC>     // 出生日期
    //      Constellation: string("摩羯座")                     // 星座
    //      ChineseZodiac: string("卯兔")                       // 生肖
    //      Sex:           int(1)                              // 性别：1为男性，0为女性
    //      Length:        int(18)                             // 号码长度
    //      CheckBit:      string("2")                         // 校验码
    //  }
    //  <nil>                                              // 错误信息
    // ]

    // 生成可通过校验的假身份证号
    ffmt.P(idvalidator.FakeId()) // 随机生成
    ffmt.P(idvalidator.FakeRequireId(true, "江苏省", "200001", 1)) // 生成出生于2000年1月江苏省的男性居民身份证

    // 15位号码升级为18位
    ffmt.P(idvalidator.UpgradeId("610104620927690"))
    // []interface {}[
    //  string("610104196209276908") // 升级后号码
    //  <nil>                        // 错误信息
    // ]
}

源码链接

• https://github.com/guanguans/id-validator

相关项目

• jxlwqq/id-validator，jxlwqq
• jxlwqq/id-validator.py，jxlwqq
• mc-zone/IDValidator，mc-zone
• renyijiu/id_validator，renyijiu

参考资料

• 中华人民共和国公民身份号码
• 中华人民共和国民政部：行政区划代码
• 中华人民共和国行政区划代码历史数据集
• 国务院办公厅关于印发《港澳台居民居住证申领发放办法》的通知
• 港澳台居民居住证