三年磨一剑！Go 桌面框架 Wails 发布 v3公测版：多窗口、AST 绑定、透明构建系统一次到位

go install github.com/wailsapp/wails/v3/cmd/wails3@latest
wails3 setup

wails3 init -n myapp
cd myapp
wails3 dev

myapp/
├── README.md
├── Taskfile.yml                 # 构建任务定义
├── build/                       # 构建相关配置
│   ├── Taskfile.yml
│   ├── android/
│   ├── appicon.icon/
│   ├── appicon.png
│   ├── config.yml
│   ├── darwin/
│   ├── docker/
│   ├── ios/
│   ├── linux/
│   └── windows/
├── frontend/                    # 前端代码
│   ├── Inter\ Font\ License.txt
│   ├── index.html
│   ├── package.json
│   ├── public/
│   ├── src/
│   ├── tsconfig.json
│   └── vite.config.ts
├── go.mod
├── go.sum
├── greetservice.go              # 一个示例服务
└── main.go                      # 应用入口

11 directories, 14 files

$wails3 dev
Wails v3.0.0-beta.2 › Build
task: [darwin:common:go:mod:tidy] go mod tidy
task: [darwin:common:generate:icons] wails3 generate icons -input appicon.png -macfilename darwin/icons.icns -windowsfilename windows/icon.ico -iconcomposerinput appicon.icon -macassetdir darwin
task: [darwin:common:generate:bindings] wails3 generate bindings -f '-buildvcs=false -gcflags=all="-l"' -clean=true -ts -i
Wails v3.0.0-beta.2 › Generate Bindings
 ▀ Loading packages... (0s)task: [darwin:common:install:frontend:deps:npm] npm install
 INFO  Processed: 238 Packages, 1 Service, 1 Method, 0 Enums, 0 Models, 1 Event in 39.01382603s.                                  
 INFO  Output directory: /Users/tonybai/test/go/wails-v3/myapp/frontend/bindings

added 24 packages in 41s

9 packages are looking for funding
  run `npm fund` for details
task: [darwin:common:frontend:run:npm] npm run build:dev -q

> frontend@0.0.0 build:dev
> vite build --minify false --mode development

vite v8.2.0 building client environment for development...
✓ 35 modules transformed.
computing gzip size...
dist/index.html                 3.20 kB │ gzip:  1.23 kB
dist/assets/index-Bgw7f08b.js  89.57 kB │ gzip: 23.05 kB

✓ built in 73ms
task: [darwin:build:native] go build -buildvcs=false -gcflags=all="-l" -o "bin/myapp"

Need documentation? Run: wails3 docs
 ♥   If Wails is useful to you or your company, please consider sponsoring the project: wails3 sponsor
task: [darwin:run] mkdir -p "bin/myapp.dev.app/Contents/MacOS"
task: [darwin:run] mkdir -p "bin/myapp.dev.app/Contents/Resources"
task: [darwin:run] cp build/darwin/icons.icns "bin/myapp.dev.app/Contents/Resources"
task: [darwin:run] if [ -f build/darwin/Assets.car ]; then
  cp build/darwin/Assets.car "bin/myapp.dev.app/Contents/Resources"
fi

task: [darwin:run] cp "bin/myapp" "bin/myapp.dev.app/Contents/MacOS"
task: [darwin:run] cp "build/darwin/Info.dev.plist" "bin/myapp.dev.app/Contents/Info.plist"
task: [darwin:run] codesign --force --deep --sign - "bin/myapp.dev.app"
task: [darwin:run] "bin/myapp.dev.app/Contents/MacOS/myapp"
task: [common:install:frontend:deps:npm] npm install

added 1 package in 1s

9 packages are looking for funding
  run `npm fund` for details
task: [common:frontend:dev:npm] npm run dev -- --port 9245 --strictPort

> frontend@0.0.0 dev
> vite --port 9245 --strictPort

2:49PM INF Build Info: Wails=v3.0.0-beta.2 Compiler=go1.26.0 DefaultGODEBUG=cryptocustomrand=1,tlssecpmlkem=0,urlstrictcolons=0 CGO_CPPFLAGS= CGO_CXXFLAGS= -compiler=gc CGO_ENABLED=1 CGO_CFLAGS=-mmacosx-version-min=12.0 CGO_LDFLAGS=-mmacosx-version-min=12.0 GOARCH=amd64 GOOS=darwin GOAMD64=v1 -buildmode=exe -gcflags=all=-l
2:49PM INF Platform Info: ID=24G231 Name=MacOS Version=15.7.1 Branding=Sequoia
2:49PM INF AssetServer Info: middleware=true handler=true devServerURL=http://localhost:9245
2:49PM INF Waiting for frontend dev server to start... url=http://localhost:9245
2:49PM INF Retrying...

  VITE v8.2.0  ready in 2049 ms

  ➜  Local:   http://127.0.0.1:9245/
2:49PM INF Retrying...
2:49PM INF Connected to frontend dev server!

package main

type GreetService struct{}

func (g *GreetService) Greet(name string) string {
	return "Hello " + name + "!"
}

package main

import (
	"embed"

	"log"
	"time"

	"github.com/wailsapp/wails/v3/pkg/application"
)

// Wails uses Go's `embed` package to embed the frontend files into the binary.
// Any files in the frontend/dist folder will be embedded into the binary and
// made available to the frontend.
// See https://pkg.go.dev/embed for more information.

//go:embed all:frontend/dist
var assets embed.FS

func init() {
	// Register a custom event whose associated data type is string.
	// This is not required, but the binding generator will pick up registered events
	// and provide a strongly typed JS/TS API for them.
	application.RegisterEvent[string]("time")
}

// main function serves as the application's entry point. It initializes the application, creates a window,
// and starts a goroutine that emits a time-based event every second. It subsequently runs the application and
// logs any error that might occur.
func main() {

	// Create a new Wails application by providing the necessary options.
	// Variables 'Name' and 'Description' are for application metadata.
	// 'Assets' configures the asset server with the 'FS' variable pointing to the frontend files.
	// 'Bind' is a list of Go struct instances. The frontend has access to the methods of these instances.
	// 'Mac' options tailor the application when running an macOS.
	app := application.New(application.Options{
		Name:        "myapp",
		Description: "A demo of using raw HTML & CSS",
		Services: []application.Service{
			application.NewService(&GreetService{}), // Bind服务
		},
		Assets: application.AssetOptions{
			Handler: application.AssetFileServerFS(assets),
		},
		Mac: application.MacOptions{
			ApplicationShouldTerminateAfterLastWindowClosed: true,
		},
	})

	// Create a new window with the necessary options.
	// 'Title' is the title of the window.
	// 'Mac' options tailor the window when running on macOS.
	// 'BackgroundColour' is the background colour of the window.
	// 'URL' is the URL that will be loaded into the webview.
	app.Window.NewWithOptions(application.WebviewWindowOptions{
		Title: "Window 1",
		// Window sized to the golden ratio (1000 / 618 ≈ 1.618).
		Width:  1000,
		Height: 618,
		Mac: application.MacWindow{
			InvisibleTitleBarHeight: 50,
			Backdrop:                application.MacBackdropTranslucent,
			TitleBar:                application.MacTitleBarHiddenInset,
		},
		BackgroundColour: application.NewRGB(6, 7, 15),
		URL:              "/",
	})

	// Create a goroutine that emits an event containing the current time every second.
	// The frontend can listen to this event and update the UI accordingly.
	go func() {
		for {
			now := time.Now().Format(time.RFC1123)
			app.Event.Emit("time", now)
			time.Sleep(time.Second)
		}
	}()

	// Run the application. This blocks until the application has been exited.
	err := app.Run()

	// If an error occurred while running the application, log it and exit.
	if err != nil {
		log.Fatal(err)
	}
}

import { GreetService } from "../bindings/changeme";

window.greet = async () => {
	const name = document.getElementById("name").value;
	if (!name) return;

	try {
		const result = await GreetService.Greet(name);
		document.getElementById("result").innerText = result;
	} catch (err) {
		console.error(err);
	}
};

package main

import (
	"github.com/wailsapp/wails/v3/pkg/application"
	"github.com/wailsapp/wails/v3/pkg/events"
)

func main() {
	app := application.New(application.Options{Name: "MultiWindowDemo"})

	mainWindow := app.Window.NewWithOptions(application.WebviewWindowOptions{
		Title: "主窗口",
		URL:   "/",
	})
	mainWindow.OnWindowEvent(events.Common.WindowClosing, func(e *application.WindowEvent) {
		app.Quit()
	})

	inspector := app.Window.NewWithOptions(application.WebviewWindowOptions{
		Title: "检查器",
		Width: 480, Height: 640,
		URL: "/inspector.html",
	})
	_ = inspector

	app.Run()
}

wails3 build

go install github.com/wailsapp/wails/v3/cmd/wails3@latest
wails3 setup
wails3 init