VSCode中Shell脚本无高亮是因文件未被识别为shellscript类型，可通过手动切换语言模式、添加shebang、配置files.associations解决；无代码提示需安装并正确配置bash-language-server；source引入的变量不提示属设计限制；中文路径或空格需用绝对路径加引号或符号链接规避。
Shell脚本后缀没高亮？先确认文件关联是否生效
VSCode 默认对 .sh 文件有基础语法高亮，但如果你打开的是 .bash、.zsh 或无后缀的脚本，高亮常会失效。这不是插件问题，而是 VSCode 没把当前文件识别为 Shell 类型。
手动触发方式：点击右下角语言模式（如显示“Plain Text”），输入 shellscript 选中；或按 Ctrl+K Ctrl+M（Windows/Linux）/Cmd+K Cmd+M（macOS）快速切换。
- 临时生效：每次打开都得手动切，适合偶尔看脚本
- 永久生效：在文件顶部加 shebang 行，比如
#!/bin/bash，VSCode 会自动识别 - 批量配置：在
settings.json中加"files.associations": {"*.bash": "shellscript", "*.zsh": "shellscript"}
装了插件还是没代码提示？检查是否启用 Language Server
单纯装 Bash Debug 或 ShellMan 不等于有智能提示——真正提供补全、跳转、诊断的是 bash-language-server 这类后端服务。VSCode 的 Shell 插件大多只是前端桥接。
验证是否运行：打开命令面板（Ctrl+Shift+P），执行 Developer: Toggle Developer Tools，切到 Console 标签，输入 bash-language-server 看有无报错。
- 没安装：终端运行
npm install -g bash-language-server（需 Node.js） - 路径不对：在
settings.json中指定"bashide.languageServerPath": "/usr/local/bin/bash-language-server" - Mac M1 用户常见坑：
npm全局安装可能落在~/opt/node_modules/.bin/，路径要写全
为什么 source 的文件里变量不提示？这是设计限制
Shell 的动态加载机制（source common.sh）在静态分析阶段无法被语言服务器可靠追踪。不是插件没做，是 Bash 本身缺乏类型和作用域声明，bash-language-server 明确不解析 source 或 . 引入的文件。
实际影响：跨文件的函数调用能跳转，但变量定义、export 的环境变量几乎不会出现在补全列表里。
- workaround：把常用变量/函数集中到一个
lib.sh，并在当前脚本顶部用注释标记 // @source lib.sh（部分插件可识别这种伪指令） - 更稳的做法：用
declare -p VARNAME在调试时查值，别依赖编辑器提示猜变量名 - 注意：VSCode 内置终端执行
source后的环境，和语言服务器分析的上下文完全隔离
中文路径或空格导致语法检查失败？改用绝对路径 + 引号绕过
当脚本里含 source ./路径/含 空格/func.sh 或 source "/Users/用户/中文目录/init.sh"，bash-language-server 常直接跳过该行分析，甚至整段报红，错误信息类似 Cannot find module。
根本原因：语言服务器底层用 Node.js 的 fs.stat 解析路径，对非 ASCII 字符或未引号包裹的空格支持不稳定。
- 临时修复：把带空格/中文的路径改成符号链接，例如
ln -s "/Users/用户/中文目录" ~/zhdir，再source ~/zhdir/init.sh - 长期建议：开发时统一用英文路径，CI/CD 环境更不会出这问题
- 不要尝试改 VSCode 的 shellcheck 路径参数——它只控制 lint 工具位置，不影响 language server 的文件解析逻辑
