必须先安装package control，它是sublime text 3插件和构建系统的底层依赖；按ctrl+`粘贴官方2026年有效命令执行后重启，再通过package control: install package安装pawn syntax插件，并正确配置构建系统path指向pawno目录。
Sublime Text 3 安装后必须先装 Package Control
没装 Package Control，后续所有插件和构建系统都加不进去。它不是可选组件，是底层依赖。
打开 Sublime Text，按 Ctrl+` 调出控制台，粘贴官方安装命令（注意：2026 年仍有效）：
import urllib.request,os; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); open(os.path.join(ipp, pf), 'wb').write(urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read())
执行后等几秒，弹出成功提示即完成。务必重启 Sublime，否则 Preferences → Package Control 菜单项不会出现。
Pawn 语法高亮插件名是 “Pawn Syntax”，不是 “Pawn” 或 “PAWN”
在 Command Palette（Ctrl+Shift+P）中输入 Package Control: Install Package，等待列表加载完毕（通常需 10–20 秒），再搜 Pawn Syntax —— 拼错、大小写不对、多空格或少字母都会搜不到。
安装完成后，打开任意 .p 或 .inc 文件，手动设置语法模式：
- 点击
View → Syntax → Pawn - 或右下角状态栏点击当前语法名，选择
Pawn
若仍无高亮，检查是否误选了 Pawn (Old) 或其他同名插件；多个 Pawn 插件共存时容易冲突，只保留一个 Pawn Syntax 即可。
构建系统里 path 必须指向 pawno 文件夹，不是 pawncc.exe 文件
"path" 字段填的是可执行文件所在目录路径，不是 exe 全路径。填错会导致 Unable to find command "pawncc.exe" 或直接报 command not found。
典型正确配置（Windows）：
{
"cmd": ["pawncc.exe", "-i includes", "$file", "-;+"],
"path": "D:/Pawn/pawno",
"file_regex": "^(.*?):([0-9]+):([0-9]+):\s+(.*)$",
"selector": "source.pawn"
}
关键点：
-
path值末尾不加斜杠，也不含pawncc.exe -
pawno文件夹内必须有pawncc.exe和amxmodx相关的includes子目录（否则-i includes会失败） -
$file是当前保存的 .p 文件完整路径，未保存时构建会静默失败
编译失败时先看 Sublime 底部状态栏和输出面板里的真实错误行
Sublime 默认构建输出被截断，只显示前几行。真正关键的错误（比如 undefined symbol、include file not found、too many errors）常藏在后面。
解决方法：
- 按
Ctrl+Shift+B打开构建面板后，用鼠标拖动滚动条到底部 - 或在输出窗口中右键 →
Select All→Copy到编辑器里全文查看 - 常见陷阱：
includes路径写成绝对路径但未同步到pawno/includes；#include <some.inc></some.inc>中的文件实际放在scripting/include/下却没更新-i参数
最易被忽略的是：Pawn 编译器对中文路径极其敏感，哪怕项目文件夹名含中文，pawncc.exe 就会直接退出且不报错——务必保证整个路径（从盘符开始）全是英文和数字。
