AutoSemiColon需解压为文件夹放入Packages目录，且main.py必须存在；键位冲突或语法模式（如JSX/TSX）不匹配会导致失效，需检查key bindings并手动设置语法为JavaScript。
AutoSemiColon.sublime-package 装不上？先确认是不是被插件管理器屏蔽了
Sublime Text 4 默认禁用未签名的第三方插件包，AutoSemiColon.sublime-package 就属于这类——它没走 Package Control 官方渠道，手动丢进 Packages/ 目录后也不会自动激活。
常见错误现象：Preferences → Package Settings 里压根不显示 AutoSemiColon 选项；敲代码时按分号键毫无反应。
- 别把
AutoSemiColon.sublime-package文件直接扔进Packages/根目录（这是 Sublime 的插件安装区，但只认“解压后带main.py的文件夹”） - 正确做法是：解压该
.sublime-package文件（它本质是个 zip），得到一个叫AutoSemiColon的文件夹，再把这个文件夹整个放进Packages/ - 路径示例：
Packages/AutoSemiColon/main.py必须存在，否则插件加载失败
插件生效但不自动加分号？检查 key binding 是否被覆盖
这个插件默认监听 ; 键，但如果你装了 Emacs Pro Essentials、SublimeCodeIntel 或自定义过 Default (Windows).sublime-keymap，就可能冲突。
使用场景：你在 JS/Python 文件里敲 ;，光标停住，没触发补全或插入分号。
- 打开
Preferences → Key Bindings，左侧是默认键位，右侧是用户键位。搜索semi或;，看有没有重复绑定 - 重点检查是否有一条类似
{"keys": [";"], "command": "insert", "args": {"characters": ";"}}的规则——它会抢在 AutoSemiColon 前执行，导致插件无响应 - 临时解决：删掉用户 keymap 里所有针对
;的绑定，重启 Sublime
JS/TS 文件里自动加分号失效？语法高亮模式影响插件判断
AutoSemiColon 只在特定 scope 下工作，比如 source.js 或 source.ts，但如果当前文件被识别成 source.js.jsx 或 source.tsx，它就可能静默退出。
性能影响很小，但它不做 scope 回退匹配，只严格比对。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Set Syntax: JavaScript，强制切回纯 JS 模式试试 - 观察右下角状态栏显示的语法名，确保是
JavaScript而不是JavaScript (Babel)或React JSX - 如果必须用 JSX/TSX，得改插件源码里的
valid_scopes列表（在Packages/AutoSemiColon/main.py第 20 行左右），加进source.js.jsx
分号插到括号/引号里面去了？这是插件的 scope 匹配逻辑缺陷
它靠正则找当前行末尾的“可加分号位置”，但遇到 if (a) { 或 console.log("hello" 这种未闭合结构时，容易误判插入点。
这不是 bug，是设计取舍：优先快，不深读 AST。
- 典型错误现象：输入
console.log("hello"后按;，结果变成console.log("hello";) - 避免方式：确保字符串、括号、花括号都已闭合再按分号；或者养成先按
Enter换行再补;的习惯 - 不建议强行修改正则逻辑——插件本身只有 80 行，但 scope 边界判断一旦改错，会导致整行插入失败
