windows下需将terminal.integrated.defaultprofile.windows设为wsl发行版名（如"ubuntu"），与wsl -l -v首列完全一致，修改后须重启vscode生效。
Windows下用WSL2时，terminal.integrated.defaultProfile.windows 怎么设才生效
VSCode默认在Windows上启动的是PowerShell或CMD，即使你装了WSL2，不显式配置，它不会自动用bash或zsh。关键不是“能不能打开WSL”，而是终端启动时默认跑哪个Shell。
必须在设置中明确指定profile，并确保路径指向WSL发行版的Shell可执行文件：
-
terminal.integrated.defaultProfile.windows设为"Ubuntu"（或其他你安装的发行版名，如"Debian"），不是"bash"或"wsl" - 该名称需与
wsl -l -v输出的第一列完全一致（区分大小写） - 如果改了设置没反应，重启VSCode——这个配置不支持热重载
- 若提示“Profile not found”，说明发行版名拼错，或WSL未初始化完成（首次启动后需手动运行一次
wsl）
macOS里shellIntegration.enabled 开启后终端乱码或卡住
macOS默认Shell已从bash切到zsh，但VSCode的Shell集成（Shell Integration）对zsh插件（如oh-my-zsh）兼容性较差，尤其在PROMPT含ANSI转义或异步命令时容易挂住。
实操建议：
- 先确认当前Shell：
echo $SHELL，确保是/bin/zsh而非/bin/bash - 临时禁用Shell Integration：把
terminal.integrated.shellIntegration.enabled设为false - 若坚持启用，删掉
~/.zshrc里所有precmd/zle相关hook，或注释掉oh-my-zsh加载行再试 - VSCode 1.85+ 对
zsh支持更好，但仍有小概率在RPROMPT含动态内容时失败
Linux桌面环境（GNOME/KDE）下terminal.integrated.profiles.linux 配置无效
Linux不像Windows/macOS有统一Shell发现机制，VSCode依赖profiles.linux手动声明路径，且必须用绝对路径+完整参数，否则会静默回退到/bin/bash。
常见失效原因：
- 路径写成
"bash"或"/usr/bin/bash"——缺-i参数，无法交互，VSCode直接跳过 - 用了
fish但没加--login，导致~/.config/fish/config.fish不加载，环境变量缺失 - 路径含空格或符号（如
/home/user/my shell）没加引号，JSON解析失败 - 实际生效的是
terminal.integrated.defaultProfile.linux，它必须是profiles.linux里某个key，不能凭空写
正确示例（在settings.json中）：
"terminal.integrated.profiles.linux": {
"zsh": {
"path": "/usr/bin/zsh",
"args": ["-i", "-l"]
}
},
"terminal.integrated.defaultProfile.linux": "zsh"
跨平台项目共享settings.json时，Shell路径怎么避免冲突
直接在工作区.vscode/settings.json里硬编码defaultProfile会导致Windows用户拉代码后终端打不开——因为ubuntu profile在macOS/Linux根本不存在。
安全做法只有两个：
- 工作区设置里**完全不配**
defaultProfile和profiles，让各平台用各自系统默认值；需要时按Ctrl+Shift+P→Terminal: Select Default Profile手动选 - 用
settings.json的os条件配置（VSCode 1.84+）："terminal.integrated.defaultProfile.linux": "zsh"和"terminal.integrated.defaultProfile.windows": "Ubuntu"可共存，VSCode只读取匹配系统的那一项 - 千万别用
env变量或脚本动态生成路径——VSCode的settings.json不支持逻辑判断
最常被忽略的一点：WSL2的Ubuntu profile在Windows上有效，但在纯Linux系统里写这个字段会导致整个终端配置不可用，连Fallback都触发不了。
