Sublime Text无官方GitLab插件，需组合GitSavvy与gitlab-ci-lint实现协同开发：GitSavvy支持本地Git操作但不对接GitLab API，gitlab-ci-lint须手动下载二进制并硬编码路径配置，二者均依赖显式路径设置与格式约定，无法自动联动提交或管理MR。
Sublime Text 本身没有官方 GitLab 插件，所谓“GitLab 插件”实际是组合使用 GitSavvy（本地 Git 操作） + gitlab-ci-lint（CI 配置校验） + 手动集成方式完成协同开发闭环——不是一键安装就能连上 GitLab 的“插件”，而是靠路径硬编码、格式约定和配置联动。
GitSavvy 能做什么、不能做什么
GitSavvy 是 Sublime 内最成熟的 Git 客户端，它调用系统 git 命令行，不依赖网络、不对接 GitLab API，因此它能：status、commit、push、diff、rebase 等所有本地 Git 操作；但它不能：创建 MR、评论代码行、查看 pipeline 状态、同步 GitLab issue。这些必须跳转浏览器或用 CLI 工具（如 glab）补足。
- 确保系统 PATH 中有可用的
git：终端运行git --version成功，但 Sublime 双击启动时可能读不到 PATH —— 若GitSavvy报 “git not found”，需在Preferences → Package Settings → GitSavvy → Settings中显式设置"git_path": { "linux": "/usr/bin/git", "osx": "/opt/homebrew/bin/git", "windows": "C:\Program Files\Git\bin\git.exe" } - 项目根目录必须含
.git目录，否则GitSavvy不激活；若打开子目录文件，它不会自动向上查找.git - 中文路径/文件名默认支持，但 Windows 上若出现乱码，检查
git config --get core.quotepath是否为false，不是则执行git config --global core.quotepath false
gitlab-ci-lint 怎么接入 Sublime 校验 .gitlab-ci.yml
gitlab-ci-lint 是 GitLab 官方 CLI 工具，不是 npm 包，也不走 PATH 查找——Sublime 启动时不继承 shell 环境变量，双击打开时根本找不到它。必须手动下载二进制并写死路径。
抓取指定 GitHub用户的 Stars 项目，生成标准化中文 Markdown 报告。用户提及「分析 GitHub stars」「导出收藏项目」「汇总 GitHub 星标」「生成 stars 报告」或粘贴含 ?tab=stars 的链接时触发。执行通过 bash...
- 从 GitLab releases 页面 下载对应平台版本（Linux/macOS 无后缀，Windows 是
gitlab-ci-lint.exe） - 放固定路径：
/usr/local/bin/gitlab-ci-lint（macOS/Linux），或C: oolsgitlab-ci-lint.exe（Windows） - 在
SublimeLinter设置中加配置（注意名字是gitlabcilint，不是gitlab-ci-lint；executable必须是数组；--format json是必需参数）：
{
"linters": {
"gitlabcilint": {
"executable": ["/usr/local/bin/gitlab-ci-lint"],
"args": ["--format", "json"],
"disable": false
}
}
}
保存后，打开 .gitlab-ci.yml 文件，若有语法错误或无效关键字（如错写 script: 为 scripts:），会实时标红提示。
为什么不用“GitLab 插件”而坚持手动配
目前没有任何 Sublime 插件能稳定对接 GitLab REST API 或 GraphQL 接口：所有声称“GitLab Integration”的第三方插件（如 GitLabSync、SublimeGitLab）均已停更，且依赖已废弃的 GitLab v4 API 或 OAuth2 token 自动刷新机制，2026 年起基本无法通过认证。即使强行启用，也会在创建 MR 时卡在 401 Unauthorized 或返回空响应。
- GitLab 2025 年起强制要求 Personal Access Token 使用
apiscope +read_api+write_repository组合，旧插件只请求api单 scope，权限不足 - Sublime 的 Python 插件环境（Py3.8+）与现代 requests 库 TLS 版本、证书链存在兼容问题，导致 HTTPS 请求静默失败
- 真正需要 MR 管理、pipeline 触发、issue 关联等操作时，直接用
glab mr create或浏览器更可靠——Sublime 只负责写代码、提 commit、校验 CI，分工明确反而少出错
真正容易被忽略的是：CI 配置校验和 Git 操作之间没有自动联动。改完 .gitlab-ci.yml 后，git add 和 git commit 仍需手动触发；Sublime 不会因为你修好了 lint 错误就帮你自动暂存文件。这看似麻烦，实则是刻意设计——避免误提交未验证的变更。
