Golang跨平台剪贴板操作库clipboard使用指南

clipboard是一个简单易用的Golang跨平台剪贴板操作库，支持Windows、macOS和Linux系统。下面详细介绍其使用方法。

安装

首先安装该库：

go get github.com/atotto/clipboard

基本功能

1. 写入剪贴板

package main

import (
	"github.com/atotto/clipboard"
	"log"
)

func main() {
	// 写入文本到剪贴板
	err := clipboard.WriteAll("Hello, Clipboard!")
	if err != nil {
		log.Fatal(err)
	}
	
	log.Println("文本已复制到剪贴板")
}

2. 读取剪贴板

package main

import (
	"github.com/atotto/clipboard"
	"log"
)

func main() {
	// 从剪贴板读取文本
	text, err := clipboard.ReadAll()
	if err != nil {
		log.Fatal(err)
	}
	
	log.Printf("剪贴板内容: %s", text)
}

高级用法

1. 监听剪贴板变化

package main

import (
	"github.com/atotto/clipboard"
	"log"
	"time"
)

func main() {
	// 获取初始剪贴板内容
	lastContent, _ := clipboard.ReadAll()
	
	for {
		// 每隔1秒检查剪贴板
		time.Sleep(time.Second)
		
		currentContent, err := clipboard.ReadAll()
		if err != nil {
			log.Printf("读取剪贴板错误: %v", err)
			continue
		}
		
		if currentContent != lastContent {
			log.Printf("剪贴板内容已更改: %s", currentContent)
			lastContent = currentContent
		}
	}
}

2. 多格式剪贴板操作

虽然clipboard库主要处理文本，但可以通过以下方式处理其他格式：

package main

import (
	"bytes"
	"github.com/atotto/clipboard"
	"image/png"
	"os"
)

func writeImageToClipboard() error {
	// 读取图片文件
	file, err := os.Open("example.png")
	if err != nil {
		return err
	}
	defer file.Close()
	
	// 解码PNG图片
	img, err := png.Decode(file)
	if err != nil {
		return err
	}
	
	// 将图片编码为字节
	var buf bytes.Buffer
	if err := png.Encode(&buf, img); err != nil {
		return err
	}
	
	// 写入剪贴板(注意: clipboard库主要设计用于文本)
	// 对于图片等二进制数据，可能需要使用平台特定的API
	return clipboard.WriteAll(buf.String())
}

跨平台注意事项

1. Linux依赖：在Linux上需要安装xsel或xclip

   # Ubuntu/Debian
   sudo apt-get install xsel xclip
   
   # CentOS/RHEL
   sudo yum install xsel xclip
   

2. Windows/macOS：无需额外依赖

3. WSL：在Windows Subsystem for Linux中，可能需要额外配置才能访问Windows剪贴板

实际应用示例

实现一个简单的剪贴板历史记录器

package main

import (
	"github.com/atotto/clipboard"
	"log"
	"os"
	"os/signal"
	"syscall"
	"time"
)

func main() {
	// 创建历史记录文件
	file, err := os.OpenFile("clipboard_history.txt", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
	if err != nil {
		log.Fatal(err)
	}
	defer file.Close()
	
	// 设置信号处理，优雅退出
	sigChan := make(chan os.Signal, 1)
	signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM)
	
	// 记录初始内容
	lastContent, _ := clipboard.ReadAll()
	if lastContent != "" {
		file.WriteString(lastContent + "\n---\n")
	}
	
	log.Println("开始监控剪贴板... (Ctrl+C退出)")
	
	// 主循环
	ticker := time.NewTicker(1 * time.Second)
	defer ticker.Stop()
	
	for {
		select {
		case <-ticker.C:
			currentContent, err := clipboard.ReadAll()
			if err != nil {
				log.Printf("错误: %v", err)
				continue
			}
			
			if currentContent != lastContent && currentContent != "" {
				log.Printf("新内容: %s", currentContent)
				file.WriteString(currentContent + "\n---\n")
				lastContent = currentContent
			}
			
		case <-sigChan:
			log.Println("退出程序")
			return
		}
	}
}

替代方案

如果clipboard库不能满足需求，可以考虑以下替代方案：

1. golang.design/x/clipboard - 更现代的剪贴板库，支持更多功能
2. srwiley/oksvg - 如果需要处理SVG等特定格式

总结

clipboard库提供了简单易用的跨平台剪贴板操作接口，适合大多数基本的剪贴板读写需求。对于更复杂的需求，可能需要结合平台特定的API或使用功能更丰富的替代库。

使用时需要注意错误处理，特别是在跨平台环境下，某些操作可能会因为系统配置或权限问题而失败。