侧边栏不显示项目文件是因默认隐藏而非故障，需用ctrl+k ctrl+b（win/linux）或cmd+k cmd+b（macos）开启；添加文件夹不等于保存项目，须执行project→save project as…生成.sublime-project文件才能持久化。
侧边栏不显示项目文件怎么办
Sublime 默认不会自动打开侧边栏，尤其新安装或重置配置后容易以为功能失效。其实只是隐藏状态，不是坏了。
常见错误现象：Ctrl+K Ctrl+B（Windows/Linux）或 Cmd+K Cmd+B（macOS）没反应——大概率是快捷键被其他软件劫持，或者你按的是大写锁定下的组合键（比如 Caps Lock 开着按了 Ctrl+K Ctrl+B）。
实操建议：
- 先手动触发：菜单栏点 View → Side Bar → Show Side Bar
- 确认快捷键是否生效：在空文件里按
Ctrl+`打开控制台，输入sublime.log_commands(True)，再试一次快捷键，看控制台是否打印toggle_side_bar - 如果没打印，说明快捷键未绑定，检查是否有插件（如
Package Control或Origami）覆盖了默认键位
添加文件夹到侧边栏就是打开项目吗
不是。Sublime 的“添加文件夹”（Add Folder to Project）只是把路径挂到当前窗口的侧边栏，不等于创建或保存了 .sublime-project 文件。关掉窗口再打开，侧边栏就空了。
使用场景：临时查几个日志、对比不同目录下的配置，不想留痕迹；但团队协作或长期维护时，必须显式保存项目。
实操建议：
- 加完文件夹后，立刻执行
Project → Save Project As…，存为xxx.sublime-project - 保存后，下次双击这个文件，或用命令行
subl --project /path/to/xxx.sublime-project启动，侧边栏才能还原 - 别依赖
Project → Quick Switch Project里的临时条目——那是内存缓存，重启就丢
侧边栏里文件名乱码或显示不全
本质是编码或字体渲染问题，不是文件损坏。尤其 Windows 上中文路径、macOS 上带特殊符号的文件名容易出这情况。
常见错误现象：文件名显示成方块、省略号（…）、或部分文字被截断；右键菜单点击无响应。
实操建议：
- 检查 Sublime 设置：打开
Preferences → Settings，确认"font_face"是支持中文的字体，比如"font_face": "Fira Code"或系统自带的"Microsoft YaHei" - 避免路径含 Unicode 控制字符（如零宽空格），可用
ls -b（macOS/Linux）或 PowerShell 的Get-ChildItem | ForEach-Object {$_.Name -replace "`u{200b}",""}检查 - 如果只是显示不全，调小
"font_size"或关闭"highlight_modified_tabs"可缓解（侧边栏会为修改标记额外占位）
想用侧边栏快速跳转函数或符号
侧边栏本身不提供代码内跳转能力，它只管文件层级。真要快速定位函数，得靠 Ctrl+P（Goto Anything）配合符号索引，而不是靠展开文件树找 utils.py 再手动搜 def parse_json。
性能影响：开启 index_files（默认开启）会让 Sublime 在后台扫描所有文件生成符号表，首次加载大项目可能卡顿 2–3 秒；但后续 Ctrl+R（Goto Symbol）就秒出结果。
实操建议：
- 确保
"index_files": true在设置中（不用改，默认就是） - 对当前文件快速跳转函数：按
Ctrl+R，输入函数名前缀即可；想跨文件搜，加@前缀，比如@parse_json - 如果
Ctrl+R不出来函数列表，检查是否禁用了show_symbol_list，或当前文件类型没被symbol_list支持（比如纯文本 .txt 就不行）
侧边栏看着简单，但“添加文件夹”和“保存项目”是两件事，“显示文件”和“索引符号”是两套机制——混用就会觉得它时灵时不灵。
