code . 是唯一推荐的启动方式,因其以当前目录为根建立完整工作区上下文,确保调试、设置、语言服务、符号跳转、全局搜索、git 面板等功能正常生效,而 open file 或 open workspace 无法提供项目级上下文。

直接用 code . 就行,但前提是命令已注册、路径正确、别误点「Open File」。
为什么 code . 是唯一推荐的启动方式
VSCode 的“项目”概念完全由你打开的文件夹决定——没有隐藏初始化,不依赖 package.json 或 tsconfig.json。只要路径存在且有读取权限,code . 就会以当前目录为根建立完整工作区上下文。
- 调试配置(
launch.json)只在文件夹级上下文里生效 - 项目级设置(
.vscode/settings.json)不会被单文件打开加载 - 语言服务器(如 TypeScript Server)需要根目录才能解析
node_modules和类型声明 - 符号跳转、Ctrl+P 全局搜索、Git 面板变更状态,全部失效于「Open File」
code 命令打不开?先查这三件事
报 command not found 或窗口一闪而过,不是 VSCode 没装,而是 shell 找不到可执行文件或参数错位。
- Mac/Linux:必须手动运行一次
Shell Command: Install 'code' command in PATH(通过Cmd+Shift+P调出命令面板);.zip 或 Snap 版本不支持此操作 - Windows:检查安装时是否勾选了 Add to PATH;若没勾,需手动把
C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加入系统环境变量 - 参数顺序不能错:
code -r .有效,code . -r会被忽略——所有 flag 必须放在路径前
多项目怎么管?别开一堆窗口
用「将文件夹添加到工作区」比反复 code -n 更高效,终端、搜索、调试、Git 面板全共享。
- 资源管理器右键 → 将文件夹添加到工作区 → 选第二个项目目录
- 最后执行 文件 → 将工作区另存为,生成
.code-workspace文件 - 该文件保存的是相对路径(如
"./backend"),不是绝对路径,适合 Git 提交和团队协作 - 临时加个子模块(比如
packages/ui)?不用立刻保存 workspace,关掉再打开会自动恢复上一次结构
真正容易被忽略的一点
VSCode 不会主动“识别”你的项目类型。它只认你给它的那个文件夹路径——哪怕里面只有 README.md,它也当项目根。所谓“Vue 项目打不开”,90% 是因为 code 没进对目录,或者终端里 npm run dev 运行在错误的路径下。别怀疑配置,先 pwd 和 ls 看清楚你在哪。











