如何快速使用GoPy：从Go包生成CPython扩展模块的完整指南

何媚京

458人浏览 · 2026-02-19 07:33:30

何媚京 · 2026-02-19 07:33:30 发布

如何快速使用GoPy：从Go包生成CPython扩展模块的完整指南

【免费下载链接】gopy gopy generates a CPython extension module from a go package. 项目地址: https://gitcode.com/gh_mirrors/go/gopy

GoPy是一个强大的工具，它能将Go语言包转换为CPython扩展模块，让开发者能够轻松地在Python中使用Go编写的功能。本文将为您提供一份简单易懂的GoPy使用指南，帮助新手快速上手这个实用工具。

安装GoPy的详细步骤

要开始使用GoPy，首先需要完成安装。请按照以下步骤操作：

安装pybindgen：
```
python3 -m pip install pybindgen
```

安装goimports：

go install golang.org/x/tools/cmd/goimports@latest

安装GoPy：

go install github.com/go-python/gopy@latest

注意：确保您已经安装了Go语言环境，并将~/go/bin添加到了系统的PATH环境变量中。

安装Python打包工具：

python3 -m pip install --upgrade setuptools wheel

对于Windows用户，需要特别注意：

请从Python官方网站下载安装Python，不要使用Microsoft Store版本
需要手动创建python3.exe（可通过复制python.exe实现）

GoPy的核心功能介绍

GoPy主要提供了以下几个核心命令，满足不同的使用需求：

pkg命令 📦

生成并编译Go包的CPython绑定，包括子目录，并生成适合分发的Python模块包。如果目标目录中还没有setup.py文件，它会创建该文件以及其他默认的打包文件。

使用示例：

gopy pkg github.com/go-python/gopy/_examples/hi

exe命令 🚀

生成并编译Go包的CPython绑定，包括子目录，并生成独立的Python可执行文件和相关的模块包。与pkg命令类似，它也会创建必要的打包文件。

使用示例：

gopy exe github.com/go-python/gopy/_examples/hi

gen命令 🔧

仅生成Go绑定文件，用于测试和开发阶段。

使用示例：

gopy gen github.com/go-python/gopy/_examples/hi

build命令 🏗️

生成并构建原始的绑定文件，不进行完整的打包。

使用示例：

gopy build github.com/go-python/gopy/_examples/hi

快速上手：创建第一个GoPy项目

下面我们通过一个简单的示例来演示如何使用GoPy：

首先获取示例代码：

go get github.com/go-python/gopy/_examples/hi

构建扩展模块：

gopy build -output=out -vm=python3 github.com/go-python/gopy/_examples/hi

在Python中使用生成的模块：

>>> import gopy
>>> hi = gopy.load("github.com/go-python/gopy/_examples/hi")
gopy> loading 'github.com/go-python/gopy/_examples/hi'...
gopy> importing 'github.com/go-python/gopy/_examples/hi'
>>> hi.Hi()
"Hello from Go!"

GoPy支持的功能矩阵

GoPy支持多种Go语言特性，以下是部分支持的示例：

数组：_examples/arrays
CGo集成：_examples/cgo
常量：_examples/consts
字符串处理：_examples/cstrings、_examples/gostrings
函数：_examples/funcs
接口：_examples/iface
映射：_examples/maps
指针：_examples/pointers
结构体：_examples/structs
切片：_examples/slices

创建可安装的Python包

GoPy可以生成完整的Python包，便于安装和分发。以下是使用setup.py的基本示例：

# 示例setup.py
from setuptools import setup, Extension

module = Extension('hi',
                   sources=['hi.c'],
                   include_dirs=['/usr/local/include'],
                   libraries=['go_hi'])

setup(name='hi',
      version='0.1',
      description='GoPy example package',
      ext_modules=[module])

生成包后，可以使用make install命令进行本地安装。