最稳方式是拖拽文件夹到VS Code窗口或用File>Open Folder…；勿选Open File，否则仅打开单文件；macOS全屏时拖拽可能被拦截；.vscode/目录会自动读取配置，勿误删。
怎么把本地文件夹加进 VS Code 工作区
直接拖拽文件夹到 VS Code 窗口里，或者用 File > Open Folder...，这是最稳的方式。别点错成 Open File，否则只打开单个文件，没法编辑整个项目。
- Windows/macOS/Linux 都支持拖拽，但 macOS 某些全屏模式下可能被系统拦截，换窗口再试
- 如果文件夹里有
.vscode/目录，VS Code 会自动读取里面的settings.json或tasks.json，别手动删它，除非你真想重置配置 - 别用
File > Add Folder to Workspace来“追加”——那是在多根工作区里加第二、第三个文件夹，不是日常打开项目该走的路
为什么打开后看不到文件树，或文件名是灰色的
大概率是没真正打开文件夹，而是打开了某个子文件，或者误点了“最近打开”里的缓存项。VS Code 的资源管理器（左侧栏）只在「已打开文件夹」状态下才显示完整结构。
- 看左上角标题栏：正常应显示
folder-name • VS Code；如果只显示file-name.txt • VS Code，说明你只是打开了文件，不是文件夹 - 右键资源管理器空白处，选
Reveal in Explorer（Windows）或Reveal in Finder（macOS），能快速定位当前工作区路径是否是你想要的 - 灰色文件名通常意味着文件被
.gitignore或 VS Code 的files.exclude隐藏了，检查设置里有没有误配"files.exclude": {"**/*.log": true}这类规则
用命令行快速打开文件夹（适合终端党）
VS Code 安装时默认注册了 code 命令，只要终端能识别它，就能秒开。
- 先确认命令可用：
code --version能输出版本号才算成功注册 - 进到目标目录后执行：
code .—— 注意那个点，代表当前目录，漏掉就打不开 - 如果提示
command not found: code，Windows 用户去 VS Code 的Help > Install 'code' command in PATH；macOS 用户按官网提示运行 shell 命令补注册；Linux 一般需手动软链或改$PATH -
code -r .可强制复用已有窗口，避免每次新开一个 VS Code 实例
多文件夹项目怎么组织才不乱
VS Code 支持多根工作区，但别一上来就堆一堆无关文件夹。真实协作中，多数人只需要一个主文件夹 + 若干符号链接（symlink）或 git submodule 子项目。
- 用
File > Save Workspace As...保存为my-project.code-workspace，之后双击它就能还原整套结构 - 工作区文件本质是 JSON，可手改
"folders"数组，但注意路径必须是绝对路径（/Users/name/project或C:\project），相对路径不生效 - 插件如
Project Manager能存多个 workspace 配置，但别依赖它替代清晰的目录结构——路径混乱时，再强的插件也救不了跳转和调试
真正容易被忽略的是：VS Code 不会自动监听文件夹外的变更。如果你把项目 A 的子模块 B 放在别处，又用软链接入，记得检查 files.watcherExclude 是否误杀了 B 的路径，否则保存后没反应，以为编辑器坏了。
