怎么用VSCode管理代码工作区_VSCode多根工作区与文件夹管理教程

冬瑶姑娘_9479

冬瑶姑娘_9479

2026-06-03

986人浏览

原创

必须通过.code-workspace文件显式创建并保存多根工作区:先清空窗口确保无打开文件夹,再用命令面板执行“workspaces: create workspace from folder”多选项目根目录,保存为my-app.code-workspace;路径推荐相对路径并置于共同父目录下,launch.json和settings需配置在工作区级且正确使用${workspacefolder:name}变量。

怎么用vscode管理代码工作区_vscode多根工作区与文件夹管理教程

VSCode 的多根工作区不是“拖几个文件夹进去就完事”,必须通过 .code-workspace 文件显式创建并保存,否则所有调试、搜索、设置行为都会退化为单根模式——你看到的只是多个文件夹平铺,不是真正的工作区。

怎么创建真正可复用的 .code-workspace 文件

直接拖拽或用 Add Folder to Workspace 往已打开的窗口里加目录,只会生成临时上下文,关掉就丢,且 Ctrl+P 搜不到其他根目录下的文件。正确做法是:

  • 关闭所有文件夹,确保 VS Code 是空窗口(状态栏显示 No folder opened)
  • 按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Workspaces: Create Workspace from Folder 并回车
  • 在弹出对话框中按住 Ctrl(Windows/Linux)或 Cmd(macOS)多选多个项目根目录
  • 保存为 my-app.code-workspace,路径建议放在所有项目的共同父级目录下(例如 ~/projects/my-app.code-workspace)

不保存就没有持久化配置,后续所有工作区级设置(如 launch.json、tasks.json、settings)都无处落脚。

.code-workspace 里路径写相对还是绝对

填错路径会导致别人拉下代码后打不开工作区,报错 Unable to open workspace: path does not exist。关键不是“对不对”,而是“谁用、在哪用”:

  • 团队协作时,优先用相对路径(如 "path": "frontend"),但必须确保该路径相对于 .code-workspace 文件所在位置有效
  • 个人开发且项目位置固定,可用环境变量(如 "path": "${env:HOME}/dev/myapp/backend"),兼顾可读性与基础跨平台兼容
  • 绝对路径(如 C:\projects\backend)严禁提交到 Git,会破坏他人环境

别把 .code-workspace 放在某个子项目里——它一旦嵌套进 frontend/ 或 backend/,相对路径就极易失效。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

launch.json 和 settings 怎么放才生效

多根工作区里,VS Code 只认工作区级的 .vscode/launch.json 和 .code-workspace 中的 settings 字段。各子文件夹下的 .vscode/settings.json 默认被忽略,除非你在工作区配置里显式启用覆盖。

  • launch.json 必须放在工作区根目录的 .vscode/ 下,每个 configuration 要配 "cwd": "${workspaceFolder:frontend}",其中 frontend 必须与 .code-workspace 中对应 folders 的 name 字段一致(没设 name 就默认取文件夹名)
  • 工作区级设置写在 .code-workspace 的 "settings" 字段里,例如:"files.exclude": {"**/node_modules": true}
  • 想让某个子文件夹保留自己的设置(比如 Python 解释器路径),得在 .code-workspace 中加 "settings": { "python.defaultInterpreterPath": "./venv/bin/python" },并确保该路径相对于对应 folder 有效

常见错误:在 .code-workspace 里写了 "eslint.workingDirectories" 却没加 ["./frontend", "./backend"],导致 ESLint 只扫第一个文件夹。

终端和搜索为什么总“找不到”其他项目

多根工作区下,VSCode 新开终端默认进入的是 .code-workspace 文件所在目录,不是你当前编辑的文件所属子项目;Ctrl+P 搜索也只在“当前活动根”下进行,除非你已显式保存为工作区文件。

  • 终端要进指定子项目,手动执行 cd frontend 或右键对应文件夹 → Open in Integrated Terminal
  • 搜索跨项目文件,必须先确认已通过 .code-workspace 加载全部根目录,再用 Ctrl+Shift+F 全局搜索(此时会包含所有根)
  • 如果仍搜不到,检查资源管理器顶部是否显示 [工作区] 标识;没有说明只是临时多文件夹,不是真工作区

最常被忽略的一点:工作区配置不会自动继承子项目里的 .vscode/settings.json,必须主动在 .code-workspace 中声明启用,或者把关键配置(如格式化、语言服务器路径)下沉到各子项目自己的 .vscode/settings.json 里。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1255

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2592

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1889

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1707

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2587

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1798

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1242

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1096

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

454

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程