如何写窗口管理脚本

wen 实用脚本 2026-06-30 229

本文目录导读：

如何写窗口管理脚本

通用脚本逻辑设计
Windows 平台详解：AutoHotkey (首选)
macOS 平台详解：Hammerspoon (推荐)
Linux 平台 (X11 / Wayland)
总结与建议

编写窗口管理脚本可以极大提升工作效率,特别是当你需要快速布局、切换多个应用程序时，根据你使用的操作系统（Windows、macOS 或 Linux），方法会有所不同。

以下是针对 Windows（AutoHotkey） 和 macOS（AppleScript/ Hammerspoon） 两个主流平台的详细指南，以及一个通用的脚本逻辑框架。

通用脚本逻辑设计

无论用什么语言或系统,一个成熟的窗口管理脚本通常包含以下核心功能：

窗口发现与定位： 找到目标程序的进程名、窗口标题或窗口句柄。
窗口状态修改： 修改位置（X,Y）、大小（W,H）、状态（最大化、最小化、置顶）。
事件触发： 通过热键（快捷键）、定时任务或特定窗口事件（如某程序打开时自动布局）。
规则匹配： 特定程序使用特定的位置或大小。

一个简单的伪代码示例（仅用于理解逻辑）：

当按下 "Win+1" 时 {
    找到 "Chrome" 窗口
    如果窗口存在 {
        设置窗口位置为 左半屏 (0,0,960,1080)
    }
}
当 "Slack" 窗口 被创建时 {
    等待 0.5秒
    设置 "Slack" 窗口位置为 右上角 (960,0,960,540)
}

Windows 平台详解：AutoHotkey (首选)

AutoHotkey（AHK） 是 Windows 上最强大、最灵活的窗口管理脚本工具，它免费、开源、语法简单。

基本安装与语法

安装： 从 autohotkey.com 下载并安装。
脚本文件： 创建一个 .ahk 文件（WindowManager.ahk），用记事本编辑。
结构： 热键:: 命令

核心命令

WinMove, WinTitle, X, Y, Width, Height：移动并调整窗口大小。
WinActivate, WinTitle：激活窗口到前台。
WinMinimize / WinMaximize / WinRestore：最小化/最大化/恢复。
WinGetActiveStats, Title, Width, Height, X, Y：获取当前激活窗口的信息。
WinGetPos, X, Y, Width, Height, WinTitle：获取指定窗口的位置和大小（非常实用，可以获取当前窗口宽高用来计算新位置）。

实战示例：一个全能的窗口管理脚本

; ==================== 配置文件头 ====================
#NoEnv
#SingleInstance Force
; ====================================================
; ---------- 功能1：窗口快速排列（左半屏/右半屏） ----------
; Win+Left 将窗口移到左半屏，Win+Right 移到右半屏
#Left::
    WinGet, ActiveWindow, ID, A
    WinGetPos, X, Y, Width, Height, ahk_id %ActiveWindow%
    SysGet, MonitorWorkArea, MonitorWorkArea
    NewWidth := MonitorWorkAreaRight / 2
    WinMove, ahk_id %ActiveWindow%, , 0, 0, NewWidth, MonitorWorkAreaBottom
    WinActivate, ahk_id %ActiveWindow%
return
#Right::
    WinGet, ActiveWindow, ID, A
    WinGetPos, X, Y, Width, Height, ahk_id %ActiveWindow%
    SysGet, MonitorWorkArea, MonitorWorkArea
    NewWidth := MonitorWorkAreaRight / 2
    WinMove, ahk_id %ActiveWindow%, , MonitorWorkAreaRight - NewWidth, 0, NewWidth, MonitorWorkAreaBottom
    WinActivate, ahk_id %ActiveWindow%
return
; ---------- 功能2：窗口置顶与取消置顶 ----------
; Win+Space 切换窗口置顶
#Space::
    Winset, AlwaysOnTop, toggle, A
    ; 显示一个简单的提示框（可选）
    WinGetTitle, Title, A
    ToolTip, 当前窗口已切换置顶状态: %Title%
    SetTimer, RemoveToolTip, 2000
return
RemoveToolTip:
    ToolTip
return
; ---------- 功能3：多显示器支持（将窗口移动到第二个显示器） ----------
; Win+Shift+Right 将窗口移到次显示器中心
#+Right::
    WinGet, ActiveWindow, ID, A
    ; 获取所有显示器的坐标（简化版，假设只有两个显示器）
    SysGet, Monitor1, Monitor, 1
    SysGet, Monitor2, Monitor, 2
    ; 如果存在第二个显示器，将窗口移动到其中心
    if (Monitor2Right > Monitor1Right) {
        NewX := Monitor2Left + (Monitor2Right - Monitor2Left - 800) // 2
        NewY := Monitor2Top + (Monitor2Bottom - Monitor2Top - 600) // 2
        WinMove, ahk_id %ActiveWindow%, , NewX, NewY, 800, 600
    }
return
; ---------- 功能4：启动特定程序并定位（如打开notepad并居中） ----------
#n::  ; Win+N
    Run, notepad.exe
    WinWait, ahk_class Notepad, , 3  ; 等待窗口出现，最多3秒
    if ErrorLevel {
        MsgBox, 无法启动记事本
        return
    }
    WinActivate
    ; 将记事本居中（屏幕宽800，高600）
    WinGetPos, , , WinW, WinH, A
    MonWidth := A_ScreenWidth
    MonHeight := A_ScreenHeight
    NewX := (MonWidth - 800) // 2
    NewY := (MonHeight - 600) // 2
    WinMove, A, , NewX, NewY, 800, 600
return

进阶技巧

进程检测： IfWinExist, ahk_exe chrome.exe 或 IfWinActive, ahk_exe chrome.exe
窗口类： 使用 Window Spy 工具（AHK自带）查看窗口的类名和进程名。
定时任务： SetTimer, CheckWindow, 1000 每1秒检查一次窗口状态。
循环动作： 配合 Loop 可以批量调整多个窗口。

macOS 平台详解：Hammerspoon (推荐)

macOS 自带的 AppleScript 处理窗口很繁琐，Hammerspoon 是一个用 Lua 语言编写的窗口管理工具，功能强大且现代。

安装与配置

安装： brew install hammerspoon 或从官网下载。
配置文件： 打开 Hammerspoon -> Preferences -> 勾选 Launch Hammerspoon at login，配置文件位于 ~/.hammerspoon/init.lua。

核心概念与命令

hs.window：窗口对象。
hs.geometry：几何形状（位置和大小）。
hs.hotkey：热键绑定。
hs.screen：屏幕对象。
window:move(rect)：移动窗口到指定矩形。
window:maximize()：最大化。

实战示例（快速窗口管理）

-- ~/.hammerspoon/init.lua
-- 基础配置
hs.logger.defaultLogLevel = "info"
-- 设置模态快捷键：按下 Ctrl+Option+Cmd 激活窗口控制模式
hs.hotkey.bind({"ctrl", "alt", "cmd"}, "space", function()
    -- 可以在这里切换不同的布局模式，简单示例：直接触发以下热键
    hs.alert.show("窗口模式已激活")
end)
-- ---------- 功能1：窗口快速定位 ----------
-- Ctrl + Option + H (左半屏)
hs.hotkey.bind({"ctrl", "alt"}, "H", function()
    local win = hs.window.focusedWindow()
    local screen = win:screen()
    local rect = screen:frame()
    win:move(rect:fromUnitRect(hs.geometry.rect(0, 0, 0.5, 1)), nil, true)
end)
-- Ctrl + Option + L (右半屏)
hs.hotkey.bind({"ctrl", "alt"}, "L", function()
    local win = hs.window.focusedWindow()
    local screen = win:screen()
    local rect = screen:frame()
    win:move(rect:fromUnitRect(hs.geometry.rect(0.5, 0, 0.5, 1)), nil, true)
end)
-- Ctrl + Option + K (居中 800x600)
hs.hotkey.bind({"ctrl", "alt"}, "K", function()
    local win = hs.window.focusedWindow()
    local screen = win:screen()
    local frame = screen:frame()
    local newSize = hs.geometry.size(800, 600)
    local newOrigin = hs.geometry.point(
        frame.x + (frame.w - newSize.w) / 2,
        frame.y + (frame.h - newSize.h) / 2
    )
    win:move(hs.geometry.rect(newOrigin, newSize))
end)
-- ---------- 功能2：窗口置顶 ----------
-- Ctrl + Option + T (切换置顶)
hs.hotkey.bind({"ctrl", "alt"}, "T", function()
    local win = hs.window.focusedWindow()
    if win then
        local isFloating = win:isAlwaysOnTop()
        win:setAlwaysOnTop(not isFloating)
        hs.alert.show(win:title() .. " 置顶状态: " .. tostring(not isFloating))
    end
end)
-- ---------- 功能3：自动布局特定程序 ----------
-- 当Safari打开时，自动放置到左半屏
hs.window.filter.new():subscribe(hs.window.filter.windowCreated, function(win)
    local appName = win:application():name()
    if appName == "Safari" then
        hs.timer.doAfter(0.2, function() -- 延迟一下确保窗口已完全初始化
            local screen = win:screen()
            local rect = screen:frame()
            win:move(rect:fromUnitRect(hs.geometry.rect(0, 0, 0.5, 1)), nil, true)
        end)
    end
end)
-- 当iTerm打开时，放置到右半屏
hs.window.filter.new():subscribe(hs.window.filter.windowCreated, function(win)
    local appName = win:application():name()
    if appName == "iTerm2" then
        hs.timer.doAfter(0.3, function()
            local screen = win:screen()
            local rect = screen:frame()
            win:move(rect:fromUnitRect(hs.geometry.rect(0.5, 0, 0.5, 1)), nil, true)
        end)
    end
end)

Linux 平台 (X11 / Wayland)

Linux 下使用窗口管理器自带的脚本功能或 wmctrl + xdotool（用于 X11）。

# 安装
sudo apt install wmctrl xdotool   # Debian/Ubuntu
# 将当前窗口移动到左上角，宽度为屏幕一半
xdotool getactivewindow windowmove 0 0
xdotool getactivewindow windowsize $(xdotool getdisplaygeometry | awk '{print $1/2}') $(xdotool getdisplaygeometry | awk '{print $2}')
# 或者更简单的wmctrl（需要知道窗口ID）
wmctrl -l                                   # 列出所有窗口
wmctrl -r "Chrome" -e 0,0,0,960,1080        # 将标题包含Chrome的窗口移动到左半屏

对于 Wayland（较新的发行版），wmctrl 不兼容，推荐使用 sway（平铺窗口管理器，自带快捷键配置）或 hyprctl（Hyprland 窗口管理器的脚本接口）。

总结与建议

新手入门： 从 Windows + AutoHotkey 或 macOS + Hammerspoon 开始，它们社区活跃、文档齐全。
按需定制： 不要一次性写很复杂的脚本，先写一个核心功能（比如左右分屏），然后再添加置顶、多显示器等功能。
调试技巧：
- Windows: 使用 ToolTip 输出变量或状态信息。
- macOS: 使用 hs.alert.show("消息")。
- 通用： 确保脚本没有语法错误，AHK 可以双击托盘图标重新加载脚本；Hammerspoon 可以在菜单栏点击 Reload Config。
安全注意： 下载第三方窗口管理脚本前，请先审查代码，避免恶意操作。能帮你写出适合自己的窗口管理脚本！如果还有具体问题（比如特定软件的处理），可以进一步提问。

本文地址： https://www.bmjup.com/post/12491.html