必须通过project → save project as…保存.sublime-project文件至项目根目录，填写合法folders数组（如[{"path": "."}]），修改后需手动重载项目，窗口标题显示项目名即生效。
如何让Sublime Text识别当前文件夹为项目根目录
Sublime Text 默认不自动把打开的文件夹当项目，Copy Relative Path、folder_exclude_patterns 等功能都依赖显式项目配置。必须手动创建或加载 .sublime-project 文件，否则所有项目级路径行为都会失效。
最直接的方式是：菜单栏 → Project → Save Project As…，选一个位置（推荐放在项目根目录下），保存为 xxx.sublime-project。保存后窗口标题栏会显示项目名，且 Copy Relative Path 才能返回有效路径。
- 如果只是用 File → Open Folder… 打开目录，它只是“工作区”，不是“项目”，
project_folder变量为空 -
.sublime-project是纯 JSON 文件，可手动编辑；但别漏掉"folders"数组，哪怕只写一个路径也必须是数组形式：[{"path": "."}] - 项目配置生效后，
$project_path变量才可用，比如在 Build System 中引用"cmd": ["python", "$project_path/src/main.py"]
复制相对路径时为什么返回空或错误路径
Copy Relative Path 命令只在已加载项目时有效，且路径计算基准是 .sublime-project 中 folders 列表里的第一个路径。如果项目配置里写了多个 path，它只认第一个。
常见失败场景：
- 当前文件不在任何
folders.path指定的目录树下（比如文件在 D:\temp，但项目配置的是C:\work） - 项目文件中
folders为空或格式错误，例如写成"folders": {"path": "."}（少了方括号） - 文件本身未保存（
untitled标签页），命令面板里该选项会置灰 - 用了
Copy File Path却误以为是相对路径——它永远输出绝对路径，名字差一个词结果完全不同
项目配置中 path 字段填什么才可靠
path 字段支持绝对路径、相对路径和点号 .，但行为差异很大。实际使用中，一律用 . 最稳妥。
原因：
-
.表示项目文件所在目录，移动整个项目时无需改配置 - 填绝对路径（如
"C:/src/myapp"）会导致项目文件无法共享给其他人，或在另一台机器上失效 - 相对路径（如
"../shared"）依赖项目文件存放位置，容易错位；Sublime 不做路径解析校验，填错也不会报错，只是功能静默失效 - Windows 下路径分隔符统一用正斜杠
/，不用\，否则 JSON 解析可能出问题
项目配置生效后，哪些功能真正依赖它
不是所有带“项目”字样的功能都真需要 .sublime-project。只有明确读取 $project_path 或 project_folder 的地方才强依赖。典型包括：
-
Copy Relative Path命令（否则返回空字符串） - Build System 中的变量替换，如
$project_path、$file_rel_path - 文件搜索范围（
Find in Files默认只搜项目内文件夹） -
folder_exclude_patterns和file_exclude_patterns设置（没项目配置时完全不生效） - 插件如
SideBarEnhancements的 “Copy Relative Path” 菜单项（同样依赖项目上下文）
容易被忽略的是：即使你只用 Copy File Path，它也不依赖项目——只要文件已保存，就始终能用。项目配置只影响“相对”类操作，不是万能开关。
