根本原因是VSCode终端启动login shell时未加载末尾export语句、shellIntegration干扰输入法事件流；需确保~/.zshrc末尾正确导出LANG和INPUT_METHOD变量，关闭shellIntegration，并彻底重启VSCode。
这不是 VSCode 的 Bug，而是终端启动时环境变量未继承、Shell 初始化流程被跳过，或新版 Shell Integration 干扰输入法事件流导致的配置问题。
为什么改了 ~/.zshrc 还是输不出中文（macOS）
VSCode 内置终端启动的是 login shell（带 -l 参数），只读 ~/.zprofile 或 ~/.zshrc 中**位于文件末尾、未被 return 或条件判断跳过**的 export 语句。常见失效场景：
-
~/.zshrc开头有return（比如某些 oh-my-zsh 插件模板自带）→ 后面的export LANG=zh_CN.UTF-8根本不执行 - 用了
if [[ -n $ZSH ]]; then ... fi包裹，但 VSCode 终端里$ZSH为空 → 变量没导出 - 把变量写在
~/.bash_profile里，但系统默认是zsh→ 完全不加载
验证方式：新开终端后运行 env | grep -i lang\|input，必须看到 LANG=zh_CN.UTF-8 和 INPUT_METHOD=ibus（或对应输入法）才算生效。
terminal.integrated.shellIntegration.enabled 必须关掉
VSCode 1.84+ 默认开启 Shell Integration，它会向终端注入大量控制序列来增强命令识别能力，但会破坏 Squirrel（鼠须管）、fcitx5 等输入法对 keyup 事件的捕获——结果就是按键盘没反应、候选框不弹、Shift 切换失效。
- 设置路径：Cmd+, → 搜
shellIntegration→ 把Terminal > Integrated > Shell Integration: Enabled设为false - 必须关闭当前所有终端标签页，再新建一个；仅关闭再打开旧标签页无效
- 这个开关关掉后，
Ctrl+Click跳转文件、命令执行时间统计等功能会消失，但中文输入恢复率接近 100%
Windows 下 PowerShell 终端输不出中文，chcp 65001 不顶用
chcp 65001 只改 Windows 控制台代码页，不改 PowerShell 底层的 [Console]::OutputEncoding 实例。输入法仍按 GBK 解码键入事件，导致静默失败。
- 正确做法是在
settings.json里配置 PowerShell 启动参数："terminal.integrated.profiles.windows": { "PowerShell": { "source": "PowerShell", "args": ["-NoExit", "-Command", "$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = [System.Text.UTF8Encoding]::new()"] } } - 别用
PowerShell Core (pwsh)作为默认 profile——它在某些 Windows 版本上对 IME 支持更差 - 如果用 Remote-SSH 连 Linux，远程端也要确保
LANG=zh_CN.UTF-8已导出，否则本地输入法事件传过去后，远端 shell 无法解析
Linux/WSL2 用户别碰 snap 版 VSCode
snap 包强制沙盒化，切断了 D-Bus 与 fcitx5/ibus 的通信路径，且无法访问 /usr/lib/x86_64-linux-gnu/libxkbcommon-x11.so 等关键输入法模块。无论你怎么配环境变量，都只是白忙。
- 卸载命令：
sudo snap remove code - 改用官方 apt 源安装：
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/packages.microsoft.gpg && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list && sudo apt update && sudo apt install code - WSL2 用户额外注意：不要从 Windows 端 VSCode 直连 WSL，改用 WSL 内执行
code --no-sandbox --enable-features=UseOzonePlatform --ozone-platform=wayland .
最常被忽略的一点：改完任何配置（尤其是 ~/.zshrc 或 settings.json），必须彻底退出 VSCode 再重开——只关终端标签页或用 Developer: Reload Window 是不够的，环境变量不会重载。
