VSCode怎么设置终端默认工作目录路径_VSCode如何指定新建终端的起始文件夹位置路径【方法】

酷芳酱_7723

酷芳酱_7723

2026-03-31

575人浏览

原创

vscode终端默认在用户主目录启动,需在settings.json中设置"terminal.integrated.cwd": "${workspacefolder}"使其自动进入当前工作区根目录;该变量在无工作区时退化为${filedirname},全无时回落至用户主目录。

vscode怎么设置终端默认工作目录路径_vscode如何指定新建终端的起始文件夹位置路径【方法】

终端启动时总在用户主目录,怎么让它默认打开到当前项目根目录

VSCode 新建终端默认从 ~(macOS/Linux)或 %USERPROFILE%(Windows)启动,而不是你打开的文件夹。这不是 bug,是 VSCode 的默认行为——它只在你**显式通过文件资源管理器打开某个文件夹**(即“Open Folder”)后,才会把该路径作为工作区根目录;但终端仍可能忽略它,除非你主动配置。

关键点:终端是否自动 cd 进去,取决于 terminal.integrated.defaultProfile.* 和 terminal.integrated.cwd 两个设置的配合,且后者优先级更高。

  • 如果设置了 terminal.integrated.cwd,它会**强制覆盖所有终端的起始路径**,无论你开的是哪个工作区
  • 想让每个工作区用各自的根目录?别硬写死路径,改用变量:${fileDirname}(当前文件所在目录)、${workspaceFolder}(当前工作区根目录)
  • Windows 用户注意:\ 路径分隔符要写成 / 或双反斜杠 \\,否则 JSON 解析失败

settings.json 里怎么写 terminal.integrated.cwd 才生效

直接在用户 settings.json 里写死路径(比如 "C:/myproject")会导致所有项目终端都跳过去,失去灵活性。正确做法是用 VSCode 提供的变量动态计算。

打开 VSCode 设置(Ctrl+,),右上角点“打开设置(JSON)”,添加这行:

"terminal.integrated.cwd": "${workspaceFolder}"

如果当前没打开文件夹(只有单个文件),${workspaceFolder} 会退化为 ${fileDirname};如果连文件都没打开,就 fallback 到用户主目录——这是最安全的兜底行为。

VSCode
VSCode

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

下载
  • 多个工作区时,${workspaceFolder} 指的是**当前活动编辑器所属的工作区根目录**,不是第一个打开的
  • 想让终端始终进当前文件所在目录?换成 ${fileDirname},但注意:如果编辑器里没打开任何文件,这个值为空,终端会失败回退到主目录
  • Mac/Linux 用户若用 zsh/bash,不需要额外配置 shell 启动脚本;但 Windows 的 PowerShell 有时会因执行策略报错,此时加一句 "terminal.integrated.profiles.windows" 显式指定 profile 更稳

为什么改了设置,新终端还是没进对目录

常见现象:改完 settings.json,重启 VSCode,新建终端依然在 ~ 或 C:UsersXXX。大概率是三个地方冲突了:

  • terminal.integrated.defaultProfile.* 对应的 shell 配置文件(如 ~/.zshrc、~/.bash_profile、$PROFILE)里有 cd 命令,它会在终端启动后立即执行,强行跳转——VSCode 的 cwd 只控制初始路径,挡不住 shell 自己的初始化逻辑
  • 你打开了多个工作区,但当前焦点不在你想设的那个工作区里,${workspaceFolder} 拿到的是另一个路径
  • 某些插件(比如 “Terminal Here”)会劫持终端创建流程,绕过 VSCode 默认设置;临时禁用插件可验证是否是它导致的

快速验证方式:关掉所有终端,Cmd+Shift+P → 输入 “Terminal: Create New Terminal”,看路径是否符合预期。如果符合,说明旧终端只是缓存了旧 cwd,不是设置没生效。

Windows 下 PowerShell 终端总卡在 PS C:> 不进项目目录

PowerShell 的执行策略(ExecutionPolicy)常阻止 profile 加载,导致你写的 cd xxx 不执行;但更隐蔽的问题是:VSCode 启动 PowerShell 时,默认用的是 pwsh.exe(跨平台版),而你本地配置的 $PROFILE 往往只对 powershell.exe 生效。

  • 先查当前终端用的是哪个:运行 $PSVersionTable.PSVersion,输出含 “Core” 就是 pwsh;不含就是 Windows PowerShell
  • 如果要用 pwsh,确保 $PROFILE 文件存在且路径正确:if (!(Test-Path $PROFILE)) { New-Item -Path $PROFILE -Type File -Force}
  • 但更推荐的做法是:不依赖 profile,直接靠 VSCode 的 cwd 设置。只要 "terminal.integrated.cwd": "${workspaceFolder}" 存在,pwsh 启动时就会直接落在那里,无需额外 cd

真正容易被忽略的是:当工作区路径含空格或中文时,PowerShell 有时会因路径解析失败而静默 fallback 到系统根目录。此时检查 VSCode 状态栏右下角显示的“当前工作区路径”是否和文件资源管理器里一致——不一致说明工作区没正确加载,${workspaceFolder} 就是空的。

相关文章

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

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

下载

相关标签:

vscode

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

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2135

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3242

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1096

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3719

7

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.26

3239

3

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.27

2798

6

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

2023.08.01

1488

3

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2559

5

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.08

3290

4

热门下载

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

精品课程

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