# qrcode_gen

**Repository Path**: lmzsby/qrcode_gen

## Basic Information

- **Project Name**: qrcode_gen
- **Description**: 二维码生成工具
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-12
- **Last Updated**: 2025-11-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QR Code Generator

一个基于 Go 语言的 QR 码生成工具，支持生成二维码并输出到控制台或文件。支持自定义颜色、大小、错误纠正级别等特性。

## 功能特性

- 生成二维码并输出到控制台或文件
- 支持自定义前景色和背景色
- 支持反转颜色
- 支持设置二维码尺寸
- 支持批量生成二维码

## 安装
### 直接下载安装使用

在 `dist` 目录下提供了预编译的可执行文件，可直接下载使用。

## 使用方法

### 单个二维码生成

```bash
# 在控制台显示 QR 码
qrcode --content "Hello World"

# 使用短选项
qrcode -c "https://example.com"

# 输出 QR 码到 PNG 文件
qrcode --content "Hello World" --output

# 指定输出文件名
qrcode -c "内容" -o --file "my-qrcode.png"

# 自定义颜色
qrcode -c "自定义二维码" --fg-color "255,0,0" --bg-color "255,255,255"

# 调整尺寸和显示选项
qrcode -c "内容" -s 512 -r
```

### 批量二维码生成

#### CSV 文件格式

创建 `data.csv` 文件：

```csv
https://example.com/page1,二维码1
https://example.com/page2,二维码2
https://example.com/page3,二维码3
Hello World,文本二维码
https://github.com,github链接
```

#### 批量生成命令

```bash
# 基本批量生成（自动创建日期时间目录）
qrcode --batch data.csv

# 指定输出目录
qrcode --batch data.csv --output-dir "我的二维码"

# 自定义尺寸和颜色
qrcode --batch data.csv -s 400 --fg-color "0,128,0"

# 使用短选项
qrcode -b data.csv -d output_qrcodes
```

### 命令行选项

#### 通用选项

| 选项 | 短选项 | 默认值 | 描述 |
|------|------|--------|------|
| `--size` | `-s` | `256` | QR 码尺寸（像素） |
| `--fg-color` | 无 | `""` | 前景色，格式：R,G,B |
| `--bg-color` | 无 | `""` | 背景色，格式：R,G,B |

#### 单个生成选项

| 选项 | 短选项 | 必需 | 描述 |
|------|------|--------|------|
| `--content` | `-c` | 是* | 需要生成 QR 码的内容 |
| `--output` | `-o` | 否 | 是否输出到文件 |
| `--re` | `-r` | 否 | 是否反转颜色显示 |
| `--file` | 无 | 否 | 输出文件名（默认使用时间戳） |

#### 批量生成选项

| 选项 | 短选项 | 必需 | 描述 |
|------|------|--------|------|
| `--batch` | `-b` | 是* | 批量生成 CSV 文件路径 |
| `--output-dir` | `-d` | 否 | 输出目录（默认使用日期时间文件夹） |

*注意：`--content` 和 `--batch` 必须提供其中一个。

### 批量处理说明

#### 输出目录结构

```text
当前目录/
├── 20231201143025/          # 自动创建的日期时间目录
│   ├── 二维码1.png
│   ├── 二维码2.png
│   ├── 文本二维码.png
│   └── github链接.png
└── data.csv
```

## 项目结构

```text
gin_study/31_qrcode/
├── cmd/
│   └── root.go          # Cobra 命令定义和实现
├── main.go              # 程序入口
├── go.mod               # Go 模块定义
└── README.md            # 项目说明文档
```

## 贡献

欢迎提交 Issue 或 Pull Request 改进本项目。