Sublime Text 中的项目

项目Project将一组文件和文件夹分组，以保持工作井井有条。它们支持特定于项目的设置和构建系统，可以快速在它们之间切换工作。
将文件夹添加到项目对于 快速跳转 和项目范围内的跳转到定义是必要的。
项目元数据存储在具有.sublime-project扩展名的 JSON 文件中。
项目元数据分为三个最顶层的节

-folders，用于包含的文件夹；
-settings，用于项目特定的设置；
-build_systems，用于项目特定的构建系统。

文件夹

将在侧边栏中列出的文件夹列表，并定义项目范围。
path : 必需

路径可以相对于项目目录或绝对路径。使用 . 表示项目文件所在的目录。

name : 可选

如果存在，它将出现在侧边栏中，而不是目录名称。

folder_exclude_patterns : 可选

通配符模式列表。与通配符模式匹配的文件夹将从项目中排除。

folder_include_patterns : 可选

通配符模式列表。与通配符模式匹配的文件夹将包含在项目中。

file_exclude_patterns : 可选

通配符模式列表。与通配符模式匹配的文件将从项目中排除。

file_include_patterns : 可选

通配符模式列表。与通配符模式匹配的文件将包含在项目中。

follow_symlinks : 可选

如果启用，将为路径解析跟踪符号链接。

示例

{
    "folders":
    [
        {
            "path": ".",
            "folder_include_patterns": ["foo"],
            "file_exclude_patterns": ["*.html"]
        },
        {
            "path": "foo",
            "name": "foo <with HTML files>"
        }
    ]
}

Sublime Text可以安装LSP和LSP-pyright插件实现python代码的自动补全，但是实际操作中，不同的操作系统安装插件后，自动补全功能并不能很好的使用
这时可以通过修改项目文件中的settings指定python版本、位置，当然，这也同样适用于虚拟环境。

示例

{
  "folders": [
    {
      "path": "~/Python_uv"
    }
  ],
  "settings": {
    "LSP": {
      "pyright": {
        "enabled": true,
        "settings": {
          "python": {
            "pythonPath": "~/Python_uv/.venv/bin/python",
            "venvPath": "~/Python_uv/.venv",
            "analysis": {
              "extraPaths": [
                "~/Python_uv/.venv/lib/python3.10/site-packages"  // 替换为你的Python版本
              ],
              // 关键：开启类型检查和补全
              "typeCheckingMode": "basic",
              "autoImportCompletion": true,  // 自动补全导入
              "useLibraryCodeForTypes": true,  // 解析第三方库类型
              "diagnosticMode": "openFilesOnly"
            }
          }
        },
        // 允许 pyright 提供补全
        "capabilities": {
          "completionProvider": {
            "triggerCharacters": [".", "(", ",", "="],
            "resolveProvider": true
          }
        }
      }
    },
    // 确保 LSP 补全优先级最高
    "lsp_completion_enabled": true,
    "lsp_completion_commit_on_tab": true,
    "lsp_completion_hide_default_completions": false
  }
}