Sublime怎么管理项目 Sublime怎么保存当前工作空间【管理】

4次阅读

sublime项目本质是保存当前已打开文件夹的配置,需先通过“open folder”加载目录再“save project as”生成.sublime-project文件,否则folders为空;添加多文件夹须手动“add folder to project”并再次“save project”才生效。

Sublime怎么管理项目 Sublime怎么保存当前工作空间【管理】

Sublime 项目不是“新建”的,是“保存当前文件夹状态”生成的

Sublime 没有传统 ide 的「新建项目向导」,它不创建空壳,也不预设模板。所谓“建项目”,本质就是把当前已打开的文件夹(或多个文件夹)固化成一个可复用的配置文件 .sublime-project

常见错误现象:点 Project → Save Project As… 后生成的文件里 "folders" 是空数组,重启后什么都没加载——因为你根本没先打开任何文件夹。

  • 必须先执行 File → Open Folder…(或拖拽整个目录到窗口),至少加载一个文件夹
  • 再点 Project → Save Project As…,推荐保存在项目根目录下,比如 myapp/myapp.sublime-project
  • 路径写成 "path": ".",而不是绝对路径,否则换机器就失效
  • 保存后会自动生成同名的 .sublime-workspace 文件,它只记你关掉时的标签页、光标位置等个人状态,不该提交到 git

添加多个文件夹进同一个项目,必须手动保存才生效

一个项目可以管理多个不相关的目录,比如同时打开 src/dist/,或微服务中的 backend/frontend/。但这不是自动的,得靠主动添加 + 显式保存。

使用场景:前端开发要实时比对源码和构建产物;全项目需并行编辑前后端代码。

  • 右键侧边栏空白处 → Add Folder to Project,或菜单 Project → Add Folder to Project
  • 添加后,.sublime-project 中的 "folders" 数组会多一条记录,支持独立配置 folder_exclude_patternsfile_exclude_patterns
  • 关键一步:添加完必须再执行一次 Project → Save Project(注意不是 Save Project As…),否则重启 Sublime 就丢失
  • 别在 "folders" 里写空对象或错字段名(如 "path": ""),整个 section 会被跳过

项目设置(settings)优先级高但容易被误读

项目级 settings 确实能覆盖全局配置,但它只对当前项目内打开的文件生效,且会被更细粒度的设置(比如你右下角手动点的缩进方式)再次覆盖。

常见错误现象:改了 "tab_size": 2 却没生效,底部状态栏仍显示 Tab Width: 4

  • 验证是否生效:打开项目内任意文件,看底部状态栏的 Tab SizeIndent using Spaces 是否显示 Project Override
  • "encoding" 是旧写法,新版应为 "default_encoding""word_wrap" 要写 true/false,不能写字符串
  • 插件配置也走这里,例如让 ESLint 只在本项目启用:"SublimeLinter.linters.eslint.disable": false,前提是插件本身支持该键名
  • 修改 .sublime-project 后,需关闭再重开项目(或用命令面板执行 Project: Reload Project),否则不生效

切换项目不能靠“最近打开文件夹”,得用真正的 .sublime-project 文件

很多人误点 Project → switch Project,结果跳转的是上次用 Open Folder… 打开的目录,不是你存好的项目配置——那只是 Sublime 记的「最近文件夹历史」,和项目无关。

正确做法是让 Sublime 加载一个完整的 .sublime-project 文件,它才真正还原文件夹结构、设置、分屏布局等。

  • 快捷键 Ctrl+Alt+Pwindows/linux)或 Cmd+Opt+Pmacos)调出的是「最近通过 Open Project 加载过的 .sublime-project 文件」列表
  • 首次使用需先通过 Project → Open Project… 手动选中你的 .sublime-project 文件,之后才会出现在切换列表里
  • 原生功能太简陋,建议装 Project Manager 插件:它把项目当索引对象管理,支持模糊搜中文、按路径排序、自定义存储位置(默认在 Packages/User/Projects/
  • 一个窗口只能加载一个项目,想对比两个项目?用 View → Layout → Columns 2 分屏,分别打开不同项目的文件夹

项目管理的核心复杂点不在操作步骤,而在「状态分离」:项目文件(.sublime-project)管结构和规则,工作区文件(.sublime-workspace)管个人状态,而 Sublime 默认不自动保存后者——你得自己决定要不要用 Save session 来备份标签页。这三个东西混在一起,最容易漏掉重载、误提交、或以为改了 settings 就立刻全局生效。

text=ZqhQzanResources