# PowerWeChat

**Repository Path**: limitmhw/PowerWeChat

## Basic Information

- **Project Name**: PowerWeChat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: release/3.4.0
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-22
- **Last Updated**: 2025-10-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PowerWeChat SDK

[![Go Build](https://github.com/ArtisanCloud/PowerWeChat/actions/workflows/go-build.yml/badge.svg?branch=release%2F3.0.0)](https://github.com/ArtisanCloud/PowerWeChat/actions/workflows/go-build.yml)
[![Go Test](https://github.com/ArtisanCloud/PowerWeChat/actions/workflows/go-test.yml/badge.svg?branch=release%2F3.0.0)](https://github.com/ArtisanCloud/PowerWeChat/actions/workflows/go-test.yml)

![star](https://gitcode.com/ArtisanCloud/PowerWechat/star/badge.svg)

你的[Star](https://github.com/ArtisanCloud/PowerWeChat/stargazers "Star")，是对我们最好的支持！也是我们坚持的动力！

---

PowerWeChat是一款基于Golang的微信SDK开发框架。目前已经覆盖了微信小程序、企业微信、微信支付等绝大部分场景的API。

PowerWeChat致力于减少微信开发中的各种上手难度，使用者只需要关心API使用，不需要关注底层微信开发中需要用到各种AES加密和解密、签名以及验证，回调通知加解密等。

## 产品特性

* 简易上手，安装一次，全覆盖微信功能接口
* 开源项目，丰富的文档内容，长期维护
* 大部分接口已经支持强类型覆盖
* 完整的测试项目，支持Web API测试

## 快速上手

```bash
go get -u github.com/ArtisanCloud/PowerWeChat/v3
```

示范：初始化实例对象，调用小程序的授权登陆接口

```go
import (
	"github.com/ArtisanCloud/PowerWeChat/v3/src/miniProgram"
	"os"
)

// 1. 初始化小程序应用实例
app, err := miniProgram.NewMiniProgram(&miniProgram.UserConfig{
	AppID:  os.Getenv("miniprogram_app_id"), // 小程序、公众号或者企业微信的appid
	Secret: os.Getenv("miniprogram_secret"), // 商户号 appID
	HttpDebug: true,
	Debug:     false,
})

// 2. 调用小程序的授权登陆接口
code := "CODE" // 前端小程序登录时，从微信获取的code
rs, err := app.Auth.Session(code)

printf(rs.OpenID)
```

更多实例接口，请打开[官方文档](https://powerwechat.artisan-cloud.com/zh/start/)

## 文档以及使用示例

* [官网文档](https://powerwechat.artisan-cloud.com/zh/start/) ：全面的接口文档，方便用户查找，使用我们开发的sdk功能
* [使用示例](https://github.com/ArtisanCloud/power-wechat-tutorial) ：您可以通过Tutorial来了解到PowerWeChat的配置和使用

  ps: 我们单独写了一个项目 [PowerWechatTutorial](https://github.com/ArtisanCloud/power-wechat-tutorial) ，基本上覆盖了大部分常用的API使用，希望能够帮助大家更快的上手Golang WeChat开发。


### 版本升级描述(V2->V3) 
* 接口添加context参数
* 解决v2的自动refresh token问题

### 如果你觉得这个项目对你有帮助，可以请作者喝杯咖啡
<img src="https://powerwechat.artisan-cloud.com/assets/receive_code.3KAeHaPN.jpg" alt="请扫我" style="display:inline; width: 150px;"/>

### 感谢打赏者，对该项目的支持
<a href="https://github.com/qindj">
  <img width="50" src="https://avatars.githubusercontent.com/u/1707762?v=4">
</a>

<a href="https://github.com/jhonor777">
  <img width="50" src="https://avatars.githubusercontent.com/u/31689092?v=4">
</a>

# 视频教程

### [快速上手](https://www.bilibili.com/video/BV1tN411u7pV/)


### [框架设计](https://www.bilibili.com/video/BV15C4y1m7vM/)


### [公众号使用](https://www.bilibili.com/video/BV1iN41157g3/?vd_source=1d120f41ee7b1be77aa8cceff5d5628f)


### [小程序使用](https://www.bilibili.com/video/BV1eu4y1H7H4/?vd_source=1d120f41ee7b1be77aa8cceff5d5628f)


### [企业微信使用](https://www.bilibili.com/video/BV1tb4y1T7Ng/?vd_source=1d120f41ee7b1be77aa8cceff5d5628f)


### API快速导航

* 公众号
	* [入门](https://powerwechat.artisan-cloud.com/zh/official-account/index.html)
	* [基础接口](https://powerwechat.artisan-cloud.com/zh/official-account/base.html)
	* [服务端](https://powerwechat.artisan-cloud.com/zh/official-account/server.html)
	* [消息](https://powerwechat.artisan-cloud.com/zh/official-account/messages.html)
	* [多客服消息转发](https://powerwechat.artisan-cloud.com/zh/official-account/message-transfer.html)
	* [消息群发](https://powerwechat.artisan-cloud.com/zh/official-account/broadcasting.html)
	* [用户](https://powerwechat.artisan-cloud.com/zh/official-account/user.html)
	* [用户标签](https://powerwechat.artisan-cloud.com/zh/official-account/user-tag.html)
	* [网页授权](https://powerwechat.artisan-cloud.com/zh/official-account/oauth.html)
	* [JSSDK](https://powerwechat.artisan-cloud.com/zh/official-account/jssdk.html)
	* [二维码](https://powerwechat.artisan-cloud.com/zh/official-account/qrcode.html)
	* [短Key托管](https://powerwechat.artisan-cloud.com/zh/official-account/shorten.html)
	* [临时素材](https://powerwechat.artisan-cloud.com/zh/official-account/media.html)
	* [素材管理](https://powerwechat.artisan-cloud.com/zh/official-account/material.html)
	* [菜单](https://powerwechat.artisan-cloud.com/zh/official-account/menu.html)
	* [卡券 ](https://powerwechat.artisan-cloud.com/zh/official-account/card.html)
	* [客服](https://powerwechat.artisan-cloud.com/zh/official-account/customer-service.html)
	* [摇一摇周边](https://powerwechat.artisan-cloud.com/zh/official-account/shake-around.html)
	* [数据统计](https://powerwechat.artisan-cloud.com/zh/official-account/data-cube.html)
	* [自动回复](https://powerwechat.artisan-cloud.com/zh/official-account/reply.html)
	* [评论数据管理](https://powerwechat.artisan-cloud.com/zh/official-account/comment.html)
	* [返佣商品](https://powerwechat.artisan-cloud.com/zh/official-account/goods.html)
* 开放平台
    * [导读](https://powerwechat.artisan-cloud.com/zh/open-platform/intro.html) 
    * [基本概念](https://powerwechat.artisan-cloud.com/zh/open-platform/basic.html) 
    * [应用场景](https://powerwechat.artisan-cloud.com/zh/open-platform/scene.html)
    * [入门](https://powerwechat.artisan-cloud.com/zh/open-platform/index.html)
    * [服务端](https://powerwechat.artisan-cloud.com/zh/open-platform/server.html)
    * [代授权](https://powerwechat.artisan-cloud.com/zh/open-platform/authorizer-delegate.html)
* 小程序
	* [用户信息](https://powerwechat.artisan-cloud.com/zh/mini-program/user-info.html)
	* [数据统计与分析](https://powerwechat.artisan-cloud.com/zh/mini-program/statistics.html)
	* [客服消息](https://powerwechat.artisan-cloud.com/zh/mini-program/service-message.html)
	* [统一服务消息](https://powerwechat.artisan-cloud.com/zh/mini-program/uniform-message.html)
	* [动态消息](https://powerwechat.artisan-cloud.com/zh/mini-program/updatable-message.html)
	* [插件管理](https://powerwechat.artisan-cloud.com/zh/mini-program/plugin.html)
	* [小程序码](https://powerwechat.artisan-cloud.com/zh/mini-program/miniprogram-code.html)
	* [消息解密](https://powerwechat.artisan-cloud.com/zh/mini-program/decode-message.html)
	* [内容安全](https://powerwechat.artisan-cloud.com/zh/mini-program/content-security.html)
	* [生物认证](https://powerwechat.artisan-cloud.com/zh/mini-program/verify-signature.html)
	* [附近的小程序](https://powerwechat.artisan-cloud.com/zh/mini-program/nearby-miniprogram.html)
	* [订阅消息](https://powerwechat.artisan-cloud.com/zh/mini-program/subscription-message.html)
	* [服务市场](https://powerwechat.artisan-cloud.com/zh/mini-program/service-market.html)
	* [直播](https://powerwechat.artisan-cloud.com/zh/mini-program/live.html)
	* [安全风控](https://powerwechat.artisan-cloud.com/zh/mini-program/risk-control.html)
	* [URL Scheme](https://powerwechat.artisan-cloud.com/zh/mini-program/url-scheme.html)
* 微信支付
    * [入门](https://powerwechat.artisan-cloud.com/zh/payment/)
    * [订单](https://powerwechat.artisan-cloud.com/zh/payment/order.html)
    * [退款](https://powerwechat.artisan-cloud.com/zh/payment/refund.html)
    * [对账单](https://powerwechat.artisan-cloud.com/zh/payment/bill.html)
    * [通知](https://powerwechat.artisan-cloud.com/zh/payment/notification.html)
    * [红包 v2](https://powerwechat.artisan-cloud.com/zh/payment/red-pack.html)
    * [JSSDK](https://powerwechat.artisan-cloud.com/zh/payment/jssdk.html)
    * [企业付款 v2](https://powerwechat.artisan-cloud.com/zh/payment/work-pay.html)
    * [商户付款](https://powerwechat.artisan-cloud.com/zh/payment/merchant-pay.html)
    * [撤销订单](https://powerwechat.artisan-cloud.com/zh/payment/retrieve-order.html)
    * [分账](https://powerwechat.artisan-cloud.com/zh/payment/profit-share.html)
* 企业微信
	* [服务端](https://powerwechat.artisan-cloud.com/zh/wecom/server.html)
	* [应用管理](https://powerwechat.artisan-cloud.com/zh/wecom/agent.html)
	* [消息发送](https://powerwechat.artisan-cloud.com/zh/wecom/message.html)
	* [通讯录](https://powerwechat.artisan-cloud.com/zh/wecom/contacts.html)
	* [网页授权](https://powerwechat.artisan-cloud.com/zh/wecom/web-auth.html)
	* [客户联系](https://powerwechat.artisan-cloud.com/zh/wecom/external-contact.html)
	* [微信客服](https://powerwechat.artisan-cloud.com/zh/wecom/customer-service.html)
	* [临时素材](https://powerwechat.artisan-cloud.com/zh/wecom/media.html)
	* [OA](https://powerwechat.artisan-cloud.com/zh/wecom/oa.html)
	* [会话内容存档](https://powerwechat.artisan-cloud.com/zh/wecom/session.html)
	* [电子发票](https://powerwechat.artisan-cloud.com/zh/wecom/e-invoice.html)
	* [小程序](https://powerwechat.artisan-cloud.com/zh/wecom/mini-program.html)
	* [JSSDK](https://powerwechat.artisan-cloud.com/zh/wecom/jssdk.html)
	* [群机器人](https://powerwechat.artisan-cloud.com/zh/wecom/robot.html)
	* [移动端](https://powerwechat.artisan-cloud.com/zh/wecom/mobile.html)

更多内容请在[官方文档](https://powerwechat.artisan-cloud.com/zh/start/) 里面进行查阅。


## 产品诞生背景
团队也是很多同学一样，从 PHP 转向 Golang，具体为什么，有什么好处，就不用我这里多介绍了吧。 但是现在因为微信的生态做私域化管理是得天独厚，所以我们公司也开发了蛮多企业微信的功能。只是在转型 golang 的过程中，没有找到像 （[easywechat](https://easywechat.com)）这样好用的 sdk。所以我们就自己想为 golang 的同学们做一点贡献。产品会长期维护，迭代，希望同学们有兴趣在使用的过程中，多给意见。



## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=ArtisanCloud/PowerWeChat&type=Date)](https://star-history.com/#ArtisanCloud/PowerWeChat&Date)


<!-- 相关产品推荐 -->
## 相关产品推荐

[PowerX 基于PowerWechat的客域系统](https://github.com/ArtisanCloud/PowerX)  
[WeyUI 一套微信生态前端组件库，适配PowerX非常友好](https://github.com/yaoyaochil/WeyUI)  
[BaiduTrans 百度翻译Go-SDK，AIGC后台提词翻译神器](https://github.com/ArtisanCloud/BaiduTrans)

<!-- CONTRIBUTORS -->
## Contributors

特别感谢 <a href="https://github.com/northseadl">Northseadl</a>为版本3所做的贡献

<a href="https://github.com/northseadl">
  <img width="50" src="https://avatars.githubusercontent.com/u/99570485?v=4">
</a>

---


<a href="https://github.com/AlvinQinwen">
  <img width="50" src="https://avatars.githubusercontent.com/u/40420020?v=4">
</a>
<a href="https://github.com/yosink">
  <img width="50" src="https://avatars.githubusercontent.com/u/10346255?v=4">
</a>
<a href="https://github.com/mryangjiang">
  <img width="50" src="https://avatars.githubusercontent.com/u/23132307?v=4">
</a>
<a href="https://github.com/zhou7507">
  <img width="50" src="https://avatars.githubusercontent.com/u/51078932?v=4">
</a>
<a href="https://github.com/jeffid">
  <img width="50" src="https://avatars.githubusercontent.com/u/22427722?v=4">
</a>
<a href="https://github.com/bugstark">
  <img width="50" src="https://avatars.githubusercontent.com/u/29302590?v=4">
</a>
<a href="https://github.com/sohenk">
  <img width="50" src="https://avatars.githubusercontent.com/u/5018122?v=4">
</a>
<a href="https://github.com/YangCSir">
  <img width="50" src="https://avatars.githubusercontent.com/u/21410207?v=4">
</a>
<a href="https://github.com/obe007">
  <img width="50" src="https://avatars.githubusercontent.com/u/16457340?v=4">
</a>
<a href="https://github.com/panw3i">
  <img width="50" src="https://avatars.githubusercontent.com/u/16938611?v=4">
</a>
<a href="https://github.com/tesun">
  <img width="50" src="https://avatars.githubusercontent.com/u/36953434?v=4">
</a>
<a href="https://github.com/liyiwu">
  <img width="50" src="https://avatars.githubusercontent.com/u/895138?v=4">
</a>
<a href="https://github.com/erlangzhang">
  <img width="50" src="https://avatars.githubusercontent.com/u/782958?v=4">
</a>
<a href="https://github.com/GJHaoo">
  <img width="50" src="https://avatars.githubusercontent.com/u/31203943?v=4">
</a>

<a href="https://github.com/beijibeijing">
  <img width="50" src="https://avatars.githubusercontent.com/u/34858346?v=4">
</a>
<a href="https://github.com/tss-tss">
  <img width="50" src="https://avatars.githubusercontent.com/u/76192676?v=4">
</a>



<br><br>
<a href="https://github.com/ArtisanCloud/PowerWeChat/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=ArtisanCloud/PowerWechat" />
</a >




## 联系我们

如果有任何意见，欢迎在Github Issue上提供意见反馈。同时，也欢迎扫描下方二维码加入微信讨论群。




## 产品主要维护者

Michael Hu

申请添加好友时，请备注产品名称，比如：“我关注PowerWechat”

<img src="https://powerx.artisan-cloud.com/assets/contact-qr-matrix-x.f35142ca.jpg" alt="请扫我" style="display:inline; width: 150px;"/>

North Wang

<img src="https://powerx.artisan-cloud.com/assets/contact_qr_north.d68f0fd0.jpg" alt="请扫我" style="display:inline; width: 150px;"/>