离线安装 code spell checker 需加 --allow-unverified 绕过签名验证，并手动配置 cspell.enabled、cspell.language 等设置启用拼写检查；词典文件需确认内置于 .vsix 中，且插件默认不检查变量名。
离线安装 Code Spell Checker 插件本身很简单，但“装上就能用”需要绕过两个隐形门槛：签名校验失败、以及插件首次激活时静默尝试联网下载词典资源。
为什么 code --install-extension 直接报错 INVALID_SIGNATURE
VSCode 离线环境下无法验证微软签名证书链，.vsix 文件即使来自官方 Marketplace 也会被拒绝。这不是文件损坏，而是安全机制触发。
- 必须加
--allow-unverified参数，例如：code --install-extension "C:/ext/streetsidesoftware.code-spell-checker-2.4.100.vsix" --allow-unverified - Windows 用户注意路径中含空格或中文时，必须用英文双引号包裹整个路径
- macOS/Linux 必须用绝对路径，
./xxx.vsix会静默失败
装完插件，注释里没红线？检查 cSpell.enabled 和语言配置
Code Spell Checker 默认只启用英文检查，且默认不扫描中文；离线环境不会自动下载额外词典，全靠本地配置驱动。
- 打开
settings.json，确认有："cSpell.enabled": true - 多语言支持必须显式声明：
"cSpell.language": ["en", "zh"]（"zh"对应简体中文词典，离线可用） - 若仍无效果，检查是否误启用了
cSpell.stringsOnly: true或cSpell.checkIdentifiers: false——它们会主动屏蔽字符串和标识符，导致“看起来没反应”
拼写建议不弹出、右键无 “Add to dictionary”？词典文件缺失
该插件离线运行依赖内置词典（如 en_US、zh_CN），这些在 .vsix 中已打包，但 VSCode 有时不会自动解压到正确位置。
- 手动验证：
unzip -l streetsidesoftware.code-spell-checker-*.vsix | grep -i "dictionaries/"，确认输出中含dictionaries/en_US/类路径 - 若缺失，说明下载的
.vsix不完整——务必从 https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker 页面点 Download Extension 按钮获取，别用第三方链接 - 装完后可执行
code --list-extensions | grep spell确认已注册；再打开一个.py或.md文件，看状态栏是否显示Spell图标
真正容易被忽略的是：它不检查变量名拼写。如果你发现 recieveData 没被标红，不是插件坏了，是它本就不该管——那是 eslint-plugin-spellcheck 的事。离线装这个插件，得另配 ESLint 环境，和 .vsix 安装完全不是一回事。
