如何在没有包控制的情况下安装Sublime插件？

Question

如何手动安装SublimeText3的软件包，不使用Package Control。我想修复一个现有软件包中的错误，因此需要一种测试更改的方法。

在命名zip文件时应遵循哪些命名惯例？ 把它放在哪里？ 还需要进行哪些其他配置？

- DesirePRG

Answer 1

下载ZIP文件，然后将其放置在您的Packages目录中，该目录可通过执行Sublime Text -> Preferences -> Browse Packages...找到。

命名zip文件时应遵循哪些命名约定？我应该把它放在哪里？我还需要进行哪些其他配置？

这取决于您要下载的特定软件包。对于某些软件包，您可以按任意名称命名。对于其他软件包，名称必须精确匹配。如果您手动从GitHub下载这些软件包，请务必阅读README中的文档。它们通常提供手动安装说明。例如，如果您想手动下载Spacegray主题，则指示您下载ZIP文件，解压缩文件夹并将其重命名为Theme - Spacegray。

- Saad

Answer 2

根据您的操作系统，您的软件包目录可能是以下之一，对于大多数软件包，只需将内容提取到此文件夹中（以其根文件夹作为名称）。

Linux: ~/.config/sublime-text-3/Packages

OS X: ~/Library/Application Support/Subime Text 3/Packages

Windows: %APPDATA%\\Sublime Text 3

- user1767754

Answer 3

我正在尝试修复现有软件包中的错误，因此需要一种测试我的更改的方法。

我曾经处于同样的情况。 接受的答案对我不起作用，因为软件包控制会自动删除文件夹。 我发现这很有帮助：

https://packagecontrol.io/docs/customizing_packages

Sublime Text 3提供了最多的覆盖包的选项。默认情况下，将通过在“Install Packages/”文件夹中放置一个.sublime-package文件来安装包。然后用户可以通过创建一个文件夹Packages/{Package Name}/并将编辑过的文件放置在其中来覆盖包中的单个文件。

另一种方法是PackageResourceViewer，它允许您从包中提取和覆盖单个文件，包括内置包。

- Andreas Haferburg

Answer 4

我认为目前最好的答案是@Andreas Haferburg所提供的。 最受欢迎的答案也提供了一些非常有用的信息，例如关于spacegray包的链接：

手册

你也可以手动安装这个主题：

1. 下载 .zip 文件
2. 解压并将文件夹重命名为 Theme - Spacegray
3. 将文件夹复制到 Packages 目录中，你可以使用菜单项 Sublime Text -> Preferences -> Browse Packages... 找到它。

这就是我第一次了解到Packages文件夹的存在以及如何找到它的路径。

使用这些答案，再加上花费大约一个周末的时间来学习如何使用Sublime Text包和语法高亮，我写了以下的 "开发者笔记 & 包开发教程"，并在GitHub上发布，以及这些 "手动安装" 说明。

简而言之，如果没有安装 Package Control，"安装包" 的方法就是将包放入 Sublime Text 的 Packages 文件夹中，路径可以通过进入 Preferences --> Browse Packages... 来找到。文件夹名称可以为任何名称，只需与 Installed Packages 目录中的内容匹配即可（该目录与 Packages 目录处于同一级别），如果要覆盖之前由 Package Control 以 "packed"（zip文件）格式安装的软件包，则需要匹配其内部的内容。

除了我的教程之外，你应该学习的主要链接是：https://packagecontrol.io/docs/customizing_packages。

1. 如何手动安装一个包

以下是我 手动安装说明 和 教程 中的一些关键引用和说明。

再次注意，我只要求在下面的说明中 Packages 文件夹中的名称为特定的名称，如 gcode，因为我的说明旨在覆盖读者可能已经安装的 Package-Control 安装包。如果您想第一次安装，或创建一个新的包，您在 Packages 文件夹中使用的文件夹名称可以是任何名称。

2. Manual installation

In Sublime Text, find the path to your Packages folder by clicking Preferences --> Browse Packages.... This will open up your GUI file manager to the path where Sublime Text packages are stored. For me on Linux Ubuntu 20.04, that's /home/gabriel/.config/sublime-text-3/Packages (even though I am running Sublime Text 4).

Now, extract this package to that folder.

Option 1: the GUI way: click the green "Code" button above --> "Download ZIP" --> save the zip file, extract it to your Packages path above, and rename it to gcode.

OR Option 2 [what I prefer]: the command-line way:

# --------------
# Option 2.A: clone the repo directly into your "Packages" dir
# --------------

# cd to the Packages dir (change this path according to your Packages path above)
cd "$HOME/.config/sublime-text-3/Packages"
# clone the repo
git clone https://github.com/ElectricRCAircraftGuy/sublime_gcode.git
# rename the repo dir to "gcode"
mv sublime_gcode gcode

# --------------
# OR Option 2.B [what I prefer]: clone the repo into wherever you want, and then
# symlink it into your "Packages" dir
# --------------

# clone repo into ~/dev
mkdir -p ~/dev
cd ~/dev
git clone https://github.com/ElectricRCAircraftGuy/sublime_gcode.git
# now symlink it into your Packages dir
ln -si ~/dev/sublime_gcode ~/.config/sublime-text-3/Packages/gcode

That's it! The gcode entry is now instantly available in your syntax highlighting menu.

Developer Notes & Package Development Tutorial

...
...
...

Sublime Text packages and syntax highlighting--how it all works

以下是关于Sublime Text包和Package Control的一些非常重要的注意事项：

1. Sublime Text packages

Sublime Text的Packages文件夹中的任何文件夹（通过Preferences --> Browse Packages...找到）都会自动立即被Sublime Text加载为“package”。

Package Control包安装的Packages有两种类型：

1. Packed: 大多数由Package Control安装的包都被“打包”成名为packageName.sublime-package的zip文件，并位于与Packages文件夹相同级别的Installed Packages目录中。
   1. 如果您手动在Packages文件夹中创建一个名为packageName的文件夹（以匹配上述打包文件），则其中任何与打包包中相同名称的文件将覆盖打包包中的文件。请参见此处的“Overrides”部分：https://packagecontrol.io/docs/customizing_packages。
2. Unpacked：安装在Packages文件夹中的任何包都会被解压缩。
   1. 开发人员可以告诉Package Control通过在其存储库的根目录下放置名为.no-sublime-package的文件来解压缩由Package Control安装的包。请参见此处：https://packagecontrol.io/docs/submitting_a_package。
   2. 如果包含需要由系统运行的二进制可执行文件，则需要未压缩的包，因为它们似乎无法从打包的zip文件中运行。

2. 语法高亮

希望我理解得都正确。

如果你想了解更多关于Sublime Text中的语法高亮和它如何映射到你的颜色方案中的 scope 条目，请阅读我的教程。

2. 测试你的更改

我正在尝试修复一个现有软件包中的错误，因此我需要一种测试我的更改的方法。

另请参阅 我教程中的这个部分：

“修改并在本地测试此软件包的更改” … 如果您想要更改或贡献代码，请按照上面的“手动安装”说明。 如果您已经通过Package Control安装了它，则位于 /home/$USERNAME/.config/sublime-text-3/Packages/gcode 文件夹中的内容将覆盖Package Control安装的 /home/$USERNAME/.config/sublime-text-3/Installed Packages/gcode.sublime-package zip文件中的内容，只要文件夹和文件名相同即可。根据需要修改Packages/gcode目录中的任何文件。每次保存时，所有打开的Sublime Text编辑器都会立即反映出更改。 作为快速测试：

1. 打开一个gcode文件。 2. 在文件中的某个文本上单击光标。 3. 使用“工具”->“开发人员”->“显示范围名称”技巧查看该文本的范围是什么。 4. 打开相应的*.sublime-syntax文件。 5. 更改或删除相应的scope的match条目中的正则表达式，以使其不再匹配您放置光标的文本。 6. 保存*.sublime-syntax文件，您将立即看到gcode文件中该文本的格式发生变化。 7. 撤消对match条目的更改并再次保存。格式将恢复到原来的样子。 8. 转到“首选项”->“自定义颜色方案”，并添加一个自定义rules条目，用于该范围的新格式。保存后，观察格式立即再次更改。完成后删除自定义条目（如果需要）。

- Gabriel Staples