sublime text手动载入独立开发工具需将插件文件夹放至packages/根目录，确保含合法sublime_plugin类的.py文件，且未被ignored_packages屏蔽，依赖库须纯python并内置。
Sublime Text怎么手动载入独立开发工具
“独立开发工具”在 Sublime 语境里通常指不通过 Package Control 安装、而是以源码形式直接集成的 Python 插件（比如自研的 MyBuildSystem、LocalDebugger 或封装了 CLI 工具的 ShellRunner）。这类工具本质是符合 Sublime Plugin API 的 Python 模块，手动载入的核心就一条：放对位置 + 确保入口模块可 import，不是复制过去就能用。
插件文件夹必须放在 Packages/ 根目录，不能嵌套
常见错误是把整个 GitHub ZIP 解压后，直接把 mytool-master/ 文件夹拖进 Packages/。Sublime 只扫描 Packages/ 下的**一级子目录**，且要求该目录内至少有一个 .py 文件定义了继承自 sublime_plugin.TextCommand、sublime_plugin.WindowCommand 或 sublime_plugin.EventListener 的类。
- 正确做法：进到
mytool-master/里，把真正含主模块（如main.py或__init__.py）的子文件夹单独拎出来 - 重命名为无空格、无特殊字符、首字母大写的规范名，例如
MyTool（不是mytool、MyTool-master或MyTool/src） - 整个
MyTool/文件夹拖进Packages/根目录 —— 用Preferences → Browse Packages…打开的路径就是它 - 检查
MyTool/内是否有.py文件，且其中包含类似class MyBuildCommand(sublime_plugin.WindowCommand):的定义
ST4 启动时找不到命令？先查 ignored_packages
插件文件夹放对了，但 Ctrl+Shift+P 搜不到命令、快捷键没反应，90% 是被 Sublime 主动忽略了。这不是加载失败，而是静默屏蔽。
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 如果里面列了
"MyTool"（大小写必须完全一致），删掉它；若不确定是否被加进去，临时清空整个数组再保存 - 重启 Sublime，再试一次命令面板搜索 —— 如果这时出现了，说明之前就是被 ignore 了
- 注意：某些插件自带自动 ignore 逻辑（比如检测到冲突时写入配置），得进插件源码查
sublime.save_settings调用点
插件依赖外部 Python 库怎么办
Sublime 的 Python 环境（ST3 是 Py33，ST4 是 Py38）和系统 Python 完全隔离，import requests 或 import numpy 会直接报 ModuleNotFoundError。不能 pip install，也不能改 sys.path 指向系统 site-packages。
- 唯一合规方式：把所需库的源码（纯 Python 版本）整个复制进插件目录，例如把
requests/文件夹放进MyTool/同级 - 确保库不含 C 扩展（如
numpy、pandas不行），否则 import 失败 - 如果库有
__init__.py且结构清晰，可在插件主文件里用相对导入，例如from . import requests - 更稳妥的做法是改用标准库替代：用
urllib.request代替requests，用json代替simplejson
最易被忽略的是作用域限制：一个插件可能只在 source.python 下触发，你在 Plain text 文件里按快捷键当然没反应。打开控制台（Ctrl+`），输入 view.scope_name(0) 看当前语法作用域，再对照插件的 .sublime-commands 或 keymap 里的 context 字段确认匹配逻辑。
