AutoHotkey中文版使用指南 — 中文支持与输入法兼容
AutoHotkey中文环境使用指南，含中文帮助文档获取、输入法兼容脚本和中文社区资源。解决搜狗拼音等中文输入法下AHK热键失效问题。
AutoHotkey 的界面为英文，但完全支持在中文 Windows 环境下使用。本指南面向希望找到 AutoHotkey 中文版本和中文使用帮助的用户，介绍如何在中文环境中高效使用 AutoHotkey v2.0.21。包括中文帮助文档获取渠道、中文社区资源、输入法兼容处理以及脚本中使用中文的注意事项。
> 读完你将能够：解决中文输入法导致 AHK 热键失效的问题，并获取中文帮助文档和社区资源。
AutoHotkey 的中文支持情况
AutoHotkey 本身是英文软件，安装界面和帮助文档默认为英文。但这完全不影响在中文操作系统上的正常使用。你可以发送中文字符和文本、处理中文文件名和路径、在脚本注释中使用中文进行说明。帮助文档中的命令说明虽然是英文但代码示例是所有语言通用的。真正需要解决的核心问题是中文帮助文档的获取和中文输入法环境下的兼容性配置。
获取中文帮助资源
中文社区维护了 AutoHotkey 帮助文档的汉化版本，提供 CHM 格式的中文帮助文件可以直接下载使用。获取渠道包括 autohotkey.org.cn（AHK 中文社区官方网站，提供中文帮助文档下载和活跃的中文论坛社区）和 ahkcn.github.io（AHK 中文文档在线版本，通过 GitHub Pages 托管可以直接在浏览器中查阅而无需下载）。下载中文 CHM 帮助文件后建议将其放在 AutoHotkey 的安装目录下方便随时查阅。如果打开 CHM 文件后显示空白页面，右键点击文件选择属性然后勾选解除锁定即可正常查看。
Bilibili 上有大量中文 AutoHotkey 视频教程，适合更喜欢视频学习的用户。搜索 AutoHotkey 教程或 AHK 入门即可找到相关视频集。
中文环境使用技巧
发送中文文本时需要在 v2.0.21 版本中将 .ahk 脚本文件保存为 UTF-8 编码格式。正确的代码格式为使用 Send 命令后跟双引号包裹的中文内容。文件的编码设置是中文环境配置中最关键的一步，编码不正确会导致中文内容变成乱码。
中文输入法兼容性是中文用户最常遇到的问题。输入法会拦截部分键盘组合键的输入导致 AHK 热键无法正常触发。解决方法包括在使用热键之前先切换到英文输入状态、在脚本中使用美元符号前缀防止热键循环触发、在脚本头部添加 InputLevel 指令提高热键的优先级捕获。不同输入法的冲突程度不同，搜狗拼音的冲突最为常见，微软拼音次之，百度输入法也有一定影响。
搜狗输入法热键兼容脚本（可直接复制使用）
将以下代码保存为 ime_fix.ahk 并运行，解决搜狗输入法下常用热键失效的问题。核心原理是用 $ 前缀防止热键被输入法拦截，#InputLevel 1 提升脚本对键盘事件的捕获优先级。
#InputLevel 1
SetKeyDelay(-1)
; 以下热键在中文输入法激活时仍能正常工作
$^!t:: {
Send "{LControl up}{LAlt up}"
Run "cmd.exe"
}
$#z:: {
Send "{LWin up}"
Run "notepad.exe"
}
$^!n:: {
Send "{LControl up}{LAlt up}"
Run "notepad.exe"
}
$^f::SendInput("{^f}") ; Ctrl+F 搜索仍正常工作
; 更多热键按以上模式添加即可> 适配说明：将脚本中 $^!t:: 等热键替换为你自己的快捷键即可。此脚本已在 Windows 10 + 搜狗拼音 14.x 环境下测试有效。
关于路径使用的一个关键原则是脚本中的文件路径如果包含中文字符可能导致部分命令执行异常。建议将所有 AHK 相关文件放在纯英文路径下。如果必须使用中文路径则需要确保 .ahk 脚本文件保存为 UTF-8 编码格式。
继续学习
配置好中文环境后，建议按以下路径继续：
- 还没安装 AHK？→ 下载 AutoHotkey
- 首次安装遇到问题？→ 安装教程
- 想开始学写脚本？→ 入门教程
- 想对比其他自动化工具？→ 工具对比
常见问题
没有官方的中文界面版本。AutoHotkey 本身几乎没有传统意义上的 UI 界面，它是一个脚本解释引擎，所以对语言界面的需求不大。需要中文支持的主要是帮助文档和教程资源，中文社区已有完善的汉化版本可以替代英文原版帮助文档。
在 v2.0.21 版本中变量名只能使用英文字母、数字和下划线，不能使用中文字符作为变量名。但是完全可以用中文来写注释文字，用注释来说明每个变量的用途和含义，这样的注释阅读起来更直观。
搜狗拼音、百度输入法、微软拼音均有可能与 AHK 热键产生冲突，其中搜狗拼音的冲突最为广泛和常见。临时切换到英文模式通常可以解决大多数情况下的冲突问题。如果需要长期稳定使用建议在脚本中添加 InputLevel 指令并配合美元符号前缀来提高兼容性。 中文用户在配置好环境后可以从下载页面 获取 AutoHotkey v2.0.21 版本。本指南的目标是帮助中文用户解决在使用中文环境时遇到的各种兼容性问题，包括中文输入法冲突、中文帮助文档获取和中文社区资源的利用。