Sublime Text如何设置项目工程_Sublime Text Project项目管理教程【完整】

秋强同学_3941

秋强同学_3941

2026-03-28

338人浏览

原创

sublime text 没有传统ide式项目工程,仅通过 .sublime-project 文件定义轻量工作区:需先 open folder… 再 save project as…,文件须存于根目录且命名合法,配置通过 settings 覆盖全局,但必须显式加载项目文件才生效。

sublime text如何设置项目工程_sublime text project项目管理教程【完整】

Sublime Text 有没有传统意义上的“项目工程”?

没有。Sublime Text 从不维护 IDE 那种带生命周期、依赖管理和构建上下文的“工程”,它只有「工作区(workspace)」和「项目定义(project definition)」两个轻量概念。真正的项目行为,全靠一个叫 .sublime-project 的 JSON 文件驱动——它不编译、不索引、不分析依赖,只负责告诉 Sublime:“这个窗口该打开哪些文件夹、用什么设置、怎么分组视图”。

  • .sublime-project 必须保存在项目根目录下,且文件名不能含空格或中文(比如 my-app.sublime-project 合法,my app.sublime-project 会失效)
  • 它必须和实际打开的文件夹绑定:没通过 File → Open Folder… 打开过目录,Project → Save Project As… 就是灰色不可点的
  • 窗口标题栏显示项目名(如 my-app — Sublime Text),这是唯一可靠的“项目已激活”信号

如何正确创建并保存一个可复用的项目?

关键不是“新建”,而是“先开夹,再存档”。Sublime 不允许从空窗口直接建项目。

  • 先点击 File → Open Folder…,选中你的项目根目录(比如 /Users/me/my-python-project)
  • 此时侧边栏出现文件树,菜单 Project → Save Project As… 才可用
  • 保存路径必须选进刚才打开的那个文件夹里,文件名填 my-python-project.sublime-project
  • 保存后,Sublime 自动在同目录生成配套的 my-python-project.sublime-workspace(记录当前打开了哪些文件、分组状态等,不建议提交到 Git)

常见错误现象:

KomikoAI
KomikoAI

KomikoAI是一款AI文本写作工具,一站式AI动漫内容创作平台。

下载
  • 保存后双击 .sublime-project 文件,结果只打开一个空窗口 → 没提前用 Open Folder… 加载过上下文,或路径写死了绝对路径(应优先用 "path": ".")
  • 用命令行 subl --project xxx.sublime-project 启动失败 → 文件里 folders 数组为空或含非法字段(最小合法结构是 {"folders": [{"path": "."}]})

怎么让某个项目用独立缩进、编码、构建系统?

全靠 settings 字段覆盖全局配置,作用域严格限定在该项目内打开的所有文件。

  • 在 Project → Edit Project 中,往 JSON 里加 "settings" 对象即可,例如:
{
  "folders": [{"path": "."}],
  "settings": {
    "tab_size": 4,
    "translate_tabs_to_spaces": true,
    "default_encoding": "UTF-8",
    "rulers": [88],
    "build_systems": [{
      "name": "Python - v3.11",
      "cmd": ["python3.11", "$file"],
      "selector": "source.python"
    }]
  }
}

注意:

  • 修改后不会热更新:必须关闭整个窗口,再用 Project → Open Project… 重新加载,或双击该 .sublime-project 文件
  • 插件是否响应这些设置,取决于它读取的是 view.settings().get("xxx") 还是硬编码的全局 Preferences.sublime-settings;验证方法是在 Python 控制台运行 sublime.active_window().active_view().settings().get("my_test_flag")
  • folder_exclude_patterns 和 file_exclude_patterns 是写在 folders 数组里的,不是 settings 下,放错位置就无效

为什么改了配置却没生效?最常被忽略的三个点
  • .sublime-project 文件被保存到了错误位置(比如桌面或 Sublime 默认 Packages 目录),导致 Sublime 根本没加载它;正确做法是:保存时路径必须指向你用 Open Folder… 打开的那个文件夹
  • 用了绝对路径写 "path": "/Users/me/project",换电脑或换用户就崩;一律用 "path": "." 或 "path": "${folder:src}"(需插件支持变量扩展)
  • 认为“只要打开这个文件夹,项目配置就自动生效”——错。必须通过 Project → Open Project… 显式加载那个 .sublime-project 文件,或者用 subl --project /path/to/project.sublime-project 启动;单纯 Open Folder… 只是加载文件树,不触发项目上下文

项目配置真正起效的前提,从来不是“文件存在”,而是“窗口由该项目文件驱动”。这点不厘清,后面所有设置都是空中楼阁。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

sublime

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2135

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3242

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1096

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3699

7

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

2023.07.05

6299

9

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

2023.07.06

1820

6

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

2023.07.24

1074

5

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

4097

7

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

3841

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程