barcode-generator

条码生成器

生成适用于零售、库存管理和标识的多种格式条码。支持 1D 条码（Code128、EAN、UPC）以及从 CSV 批量生成。

快速开始

from scripts.barcode_gen import BarcodeGenerator

# Generate barcode
gen = BarcodeGenerator()
gen.generate("123456789012", format="ean13", output="barcode.png")

# Code128 (variable length)
gen.generate("ABC-12345", format="code128", output="product.png")

# Batch from CSV
gen.batch_generate("products.csv", code_column="sku", output_dir="./barcodes")

功能

• 多种格式：Code128、EAN13、EAN8、UPC-A、Code39、ITF、ISBN
• 输出格式：PNG、SVG、PDF
• 自定义选项：尺寸、颜色、文本显示
• 批量生成：从 CSV 文件生成
• 验证：校验位计算与验证

API 参考

基本生成

gen = BarcodeGenerator()

# Generate with auto-format detection
gen.generate("123456789012", output="barcode.png")

# Specific format
gen.generate("12345678", format="ean8", output="barcode.png")

自定义

gen.generate(
    "ABC123",
    format="code128",
    output="barcode.png",
    width=300,            # Image width
    height=150,           # Image height
    show_text=True,       # Show code below barcode
    font_size=12,         # Text size
    foreground="black",   # Bar color
    background="white"    # Background color
)

批量生成

# From CSV
gen.batch_generate(
    "products.csv",
    code_column="sku",
    format="code128",
    output_dir="./barcodes",
    filename_column="product_name"  # Use product name as filename
)

# From list
codes = ["ABC001", "ABC002", "ABC003"]
gen.batch_generate_list(codes, format="code128", output_dir="./barcodes")

验证

# Validate barcode format
is_valid = gen.validate("5901234123457", format="ean13")

# Calculate check digit
check = gen.calculate_check_digit("590123412345", format="ean13")
# Returns: 7

# Generate with auto check digit
gen.generate("590123412345", format="ean13", auto_check_digit=True)

输出格式

# PNG (default)
gen.generate("123", format="code128", output="barcode.png")

# SVG (vector)
gen.generate("123", format="code128", output="barcode.svg")

# PDF
gen.generate("123", format="code128", output="barcode.pdf")

CLI 用法

# Generate single barcode
python barcode_gen.py --code "123456789012" --format ean13 --output barcode.png

# Code128
python barcode_gen.py --code "ABC-12345" --format code128 --output product.png

# Custom size
python barcode_gen.py --code "12345" --format code39 --width 400 --height 200

# Batch from CSV
python barcode_gen.py --batch products.csv --column sku --format code128 --output-dir ./barcodes

# Validate
python barcode_gen.py --validate "5901234123457" --format ean13

CLI 参数

参数	描述	默认值
--code	要编码的代码	-
--format	条码格式	code128
--output	输出文件	-
--width	图像宽度	300
--height	图像高度	150
--no-text	隐藏代码文本	False
--batch	用于批量处理的 CSV 文件	-
--column	CSV 中的代码列	code
--output-dir	输出目录	.
--validate	验证代码	-

支持的格式

格式	长度	字符	使用场景
code128	可变	ASCII	通用
ean13	13	数字	零售商品
ean8	8	数字	小型商品
upca	12	数字	美国零售
code39	可变	A-Z、0-9、符号	工业用途
itf	偶数	数字	运输
isbn13	13	数字	图书
isbn10	10	数字 + X	图书（旧版）

示例

商品标签

gen = BarcodeGenerator()

gen.generate(
    "5901234123457",
    format="ean13",
    output="product_barcode.png",
    width=250,
    height=100,
    show_text=True
)

库存标签

gen = BarcodeGenerator()

inventory = [
    {"sku": "INV-001", "name": "Widget A"},
    {"sku": "INV-002", "name": "Widget B"},
    {"sku": "INV-003", "name": "Widget C"}
]

for item in inventory:
    gen.generate(
        item["sku"],
        format="code128",
        output=f"./tags/{item['name']}.png"
    )

图书 ISBN

gen = BarcodeGenerator()

# ISBN-13 barcode
gen.generate(
    "9780134685991",
    format="isbn13",
    output="book_barcode.png"
)

批量商品标签

gen = BarcodeGenerator()

# products.csv:
# sku,product_name,price
# 123456789012,Widget A,9.99
# 234567890123,Widget B,14.99

gen.batch_generate(
    "products.csv",
    code_column="sku",
    format="ean13",
    output_dir="./product_labels",
    filename_column="product_name"
)

校验位计算

生成器可以自动计算并附加校验位：

gen = BarcodeGenerator()

# EAN-13: 12 digits + 1 check digit
gen.generate("590123412345", format="ean13", auto_check_digit=True)
# Generates barcode for "5901234123457"

# Manually calculate
check = gen.calculate_check_digit("590123412345", format="ean13")
print(f"Check digit: {check}")  # 7

依赖项

python-barcode>=0.15.0
Pillow>=10.0.0

限制

• 某些格式对长度有严格要求
• 字符必须符合格式规范
• PDF 输出可能需要额外字体
• 代码过长时，在较小尺寸下可能不易扫描