### Sublime Text 2 配置 ActionScript 3 开发环境：那些容易踩的坑和正确姿势 在配置 ActionScript 3 开发环境这件事上，Sublime Text 2 其实是一款很称手的编辑器——前提是得先把那几个关键环节卡准。不是装个插件就完事，核心是让 `mxmlc`
### Sublime Text 2 配置 ActionScript 3 开发环境：那些容易踩的坑和正确姿势
在配置 ActionScript 3 开发环境这件事上，Sublime Text 2 其实是一款很称手的编辑器——前提是得先把那几个关键环节卡准。不是装个插件就完事，核心是让 `mxmlc` 这个命令行工具能被系统正常调用，AS 文件能顺利编译，输出一个可调试的 SWF，同时解决编码与运行时共享库（RSL）的冲突问题。路径或配置项错一个，就会卡在“找不到类”或“无法加载 RSL”上。
#### 确认 `mxmlc` 命令行可用是前提
所有后续的构建步骤都依赖这条命令。如果它不在系统的 PATH 里，`Tools → Build System` 就会直接报 `'mxmlc' is not recognized`，后面的工作根本没法展开。
- 必须设置 `MXMLC_HOME` 环境变量，值指向 Flex SDK 根目录，比如 `E:\flex_sdk_4.6`
- 把 `%MXMLC_HOME%\bin` 添加到系统 `Path` 中——光设 `MXMLC_HOME` 还不够，路径得加到可执行文件的搜索范围里
- 新开一个 cmd 窗口，执行 `mxmlc -version`，看到类似 `Version 4.6.0 build 23201` 才算成功
- 如果提示“找不到 Ja va”，说明 Flex SDK 依赖的 JRE 没装，或者 `JA VA_HOME` 指向有误；Flex 4.6 要求 JDK 6 或 7，JDK 8 及以上会报 `UnsupportedClassVersionError`，这个版本兼容问题很多人会忽略
#### `runFlash.bat` 脚本：空格和参数顺序一个都不能错
Sublime 的 Build System 本质上是调用外部脚本，`runFlash.bat` 就是衔接 `mxmlc` 和当前文件的胶水。但因为 Windows 批处理对空格极其敏感，一个不留神就可能写错。
- 脚本里 `mxmlc.exe` 后面必须加空格，再接参数：`mxmlc.exe "%~1" -output "%~dpn1.swf" -debug`
- 用 `"%~1"` 包裹文件名，这样可以保证路径带空格时也能正常传入（比如 `C:\My Project\Main.as`）
- `-debug` 参数要放在末尾，或者明确指定启用，否则编译出来的 SWF 里 `trace()` 不会输出；如果需要更详细的运行日志，可以加上 `-verbose-stacktraces`
- 避免使用 `-static-link-runtime-shared-libraries=false`（默认值就是 false），否则编译时会警告“无法加载 RSL”，Flash Player 也可能会直接拒绝加载
#### AS3 构建系统中的编码和路径必须匹配 SDK 实际位置
Build System JSON 里的 `cmd` 数组，第一项是批处理路径，第二项是 `${file}`。如果 `runFlash.bat` 放在非标准路径，或者 Sublime 的工作目录并不等于文件所在目录，编译就会失败，甚至输出到错误的位置。
- `cmd` 中的路径必须是绝对路径，而且要用双反斜杠或正斜杠，例如 `C:\path\to\runFlash.bat` 或 `C:/path/to/runFlash.bat`
- `encoding` 设置为 `"GBK"` 只适用于中文 Windows 的默认编码；如果 AS 文件本身是 UTF-8 无 BOM，就应该用 `"UTF-8"`，否则中文注释或字符串会显示成乱码
- 要确保 `flex-config.xml` 中 `
true` 已经启用，否则编译器可能跳过链接必需的 RSL（比如 `framework.swc`），运行时会报 `ReferenceError: Error #1065`
#### AS3 插件和语法高亮：容易被忽略的兼容细节
Sublime Text 2 的 `ActionScript 3` 插件只提供基础的高亮和 snippets，不支持自动补全或跳转；它也不识别 `flash.display.Sprite` 这类全路径类名，只认短名 `Sprite`——这和 Flash Builder 的行为不一样，但已经是当时最简可行方案了。
- 插件包名必须叫 `ActionScript 3`（注意中间有空格），否则 `Tools → Build System` 列表里不会出现对应项
- 如果打开 `.as` 文件后右下角显示 `Plain Text`，需要手动点击切换为 `ActionScript 3`，否则缩进、括号匹配、注释符号（`//` 和 `/* */`）全部失效
- `ConvertToUTF8` 插件必须安装，否则从 Flash CS 导出的包含中文字符串的 AS 文件会显示成方块，`mxmlc` 编译时也会报 `Invalid character`
- 别试图用 SublimeCodeIntel 来补全 AS3——它根本没有 AS3 语言支持，强行配置只会导致 CPU 占用飙升、编辑器无响应
Flex SDK 版本、JDK 版本、Windows 区域设置、Sublime 插件路径大小写，这四个点只要有一个错位，编译就会停在“黑窗口一闪而过”或“生成空白 SWF”的状态。调试的时候，优先级最高的是先看 cmd 窗口输出的第一行错误信息，而不是直接去修改 `.sublime-build` 文件。
