VSCode如何修改默认终端_VSCode默认终端修改实战

风婷同学_8625

风婷同学_8625

2026-04-05

311人浏览

原创

VSCode终端默认配置需匹配profiles中定义的键名而非路径或显示名;Windows须确保terminal.integrated.defaultProfile.windows与terminal.integrated.profiles.windows中某key完全一致;WSL需手动添加profile且args发行版名须与wsl -l -v输出严格一致;macOS/Linux的defaultProfile应设为绝对路径并重启VSCode生效。

vscode如何修改默认终端_vscode默认终端修改实战

VSCode 默认终端改不了?先确认你改的是哪个配置项

VSCode 的终端行为由两个层级控制:用户级全局设置和工作区级覆盖。很多人改了 terminal.integrated.defaultProfile.windows 却没生效,是因为在 Windows 上真正起作用的是 terminal.integrated.profiles.windows 中定义的 profile 名称,而 defaultProfile 必须严格匹配其中某个 key —— 不是路径,不是显示名,是 profile 对象的键名。

常见错误现象:defaultProfile 设成 "PowerShell" 或 "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" 都无效,因为 profile 键名默认是 "PowerShell"(带空格)或 "Git Bash",但具体取决于你安装的 shell 和 VSCode 版本。

  • 打开设置(Ctrl+, ),搜索 terminal.integrated.profiles.windows,点击“在 settings.json 中编辑”
  • 检查当前 profiles 列表,找到你想设为默认的那个 shell 对应的 key,比如 "PowerShell"、"Command Prompt" 或 "Ubuntu-22.04 (WSL)"
  • 再搜索 terminal.integrated.defaultProfile.windows,确保它的值和上一步的 key 完全一致(包括大小写和空格)

WSL 作为默认终端时,为什么新窗口还是 cmd?

WSL profile 在 profiles.windows 中默认不启用,需要手动添加。VSCode 不会自动发现已安装的 WSL 发行版,必须显式声明路径和图标等字段,否则 defaultProfile 即使写了 "Ubuntu-22.04" 也会 fallback 到内置的 "Command Prompt"。

实操建议:

  • 在 settings.json 中补全 WSL profile,例如:
    "Ubuntu-22.04": {
      "path": "wsl.exe",
      "args": ["-d", "Ubuntu-22.04"],
      "icon": "terminal-linux"
    }
  • args 中的发行版名称必须和 wsl -l -v 输出的名称完全一致(区分大小写)
  • 如果使用 Windows Terminal 配合 WSL,不要把 path 设成 wt.exe —— VSCode 终端不支持嵌套启动终端模拟器

Mac/Linux 用户改 terminal.integrated.defaultProfile.osx 没反应?

macOS 和 Linux 上没有 profiles.osx 或 profiles.linux 这个配置项(VSCode 1.85+ 已移除),所有 shell 都通过 shellArgs 和 env 控制,defaultProfile 直接指向可执行文件路径即可。

VSCode
VSCode

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

下载

关键点:

  • terminal.integrated.defaultProfile.osx 应设为完整路径,如 "/opt/homebrew/bin/fish" 或 "/bin/zsh",不能只写 "fish"
  • 确保该路径对 VSCode 可见:如果用 Homebrew 安装的 shell,且 VSCode 是从 Dock 启动的,可能读不到 PATH,需用绝对路径
  • 修改后必须重启 VSCode(不是重载窗口),否则旧进程仍缓存原 shell

改完配置,新终端还是旧 shell?检查这三件事

最常被忽略的是终端复用机制:VSCode 默认复用已有终端进程,不会因配置变更重新初始化。所以即使配置正确,新开终端也可能沿用旧 session。

  • 关闭所有已打开的集成终端(点击终端面板右上角 ×,或运行命令 Terminal: Kill the Active Terminal Instance)
  • 确认没有在 .vscode/settings.json(工作区)中覆盖了用户级的 defaultProfile
  • 运行命令 Developer: Toggle Developer Tools,在 Console 中输入 terminalEnvironment 查看当前终端实际加载的 profile 名称

复杂点在于:profile 名称、路径、args、环境变量四者耦合,任意一环错位都会导致 fallback。别只盯着 defaultProfile,先让 profile 能列出来,再让它被选中。

相关文章

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

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

下载

相关标签:

vscode

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

相关专题

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

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

2023.08.07

2235

5

json是什么
json是什么

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

2023.08.23

3602

1

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

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

2023.10.13

1196

3

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

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

2025.09.10

4139

7

session失效的原因
session失效的原因

session失效的原因有会话超时、会话数量限制、会话完整性检查、服务器重启、浏览器或设备问题等等。详细介绍:1、会话超时:服务器为Session设置了一个默认的超时时间,当用户在一段时间内没有与服务器交互时,Session将自动失效;2、会话数量限制:服务器为每个用户的Session数量设置了一个限制,当用户创建的Session数量超过这个限制时,最新的会覆盖最早的等等。

2023.10.17

580

4

session失效解决方法
session失效解决方法

session失效通常是由于 session 的生存时间过期或者服务器关闭导致的。其解决办法:1、延长session的生存时间;2、使用持久化存储;3、使用cookie;4、异步更新session;5、使用会话管理中间件。

2023.10.18

876

5

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

2025.08.19

1946

14

console接口是干嘛的
console接口是干嘛的

console接口是一种用于在计算机命令行或浏览器开发工具中输出信息的工具,提供了一种简单的方式来记录和查看应用程序的输出结果和调试信息。本专题为大家提供console接口相关的各种文章、以及下载和课程。

2023.08.08

896

5

console.log是什么
console.log是什么

console.log 是 javascript 函数,用于在浏览器控制台中输出信息,便于调试和故障排除。想了解更多console.log的相关内容,可以阅读本专题下面的文章。

2024.05.29

6743

7

热门下载

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

精品课程

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