codemaid离线安装后不生效，需检查三处：settings.json中"codemaid.runonsave"是否为true且未被工作区覆盖；插件缓存目录下node_modules是否完整；项目根目录的.codemaid.json是否utf-8无bom。
CodeMaid离线安装后不生效？检查这三处路径和配置
插件装进去了但快捷键没反应、保存也不自动清理，大概率是离线环境下某些路径没被正确识别。CodeMaid依赖本地文件系统读写能力，而离线机常禁用网络代理或重定向了用户目录。
重点确认以下三项：
-
settings.json中"codemaid.runOnSave"必须设为true，且不能被工作区设置覆盖（检查右下角是否显示“Workspace”） - 插件自身缓存目录
%USERPROFILE%\.vscode\extensions\thekyles.code-maid-*下的node_modules文件夹必须完整——离线拷贝时容易漏掉隐藏的node_modules或out目录 - 若项目含
.codemaid.json配置文件，确保其路径在工作区根目录，且文件编码为 UTF-8（BOM 会触发解析失败，表现为“配置未加载”但无报错）
离线环境里CodeMaid清理C#代码变慢？关掉实时分析开关
CodeMaid默认启用后台语法树分析（用于智能排序、引用检测），但在无网络、无远程索引的离线机上，这部分逻辑会反复尝试连接微软语言服务端点，造成卡顿或假死。
手动关闭它最直接：
- 打开命令面板（
Ctrl+Shift+P），输入Preferences: Open Settings (JSON) - 添加这两项配置：
{
"codemaid.enableRealTimeAnalysis": false,
"codemaid.enableCodeLens": false
}
注意："codemaid.enableRealTimeAnalysis" 关闭后，仅影响“编辑中实时高亮/提示”，不影响保存时的批量清理动作。
为什么离线安装后CodeMaid删不掉未使用的 using？
这不是插件故障，而是离线环境缺失 Roslyn 编译器服务支持。CodeMaid 的 using 清理依赖 VS Code 内置的 C# 扩展（ms-dotnettools.csharp）提供的语义分析能力。如果这个扩展没一起离线装好，或者装了但 omnisharp.path 指向了一个不存在的本地 OmniSharp 二进制文件，清理就会静默跳过。
验证与修复步骤：
- 确认已离线安装
ms-dotnettools.csharp-*.vsix，并重启 VS Code - 检查设置中
omnisharp.path是否指向一个真实存在的路径，例如：C:\tools\omnisharp-win-x64\OmniSharp.exe - 若不想部署 OmniSharp，可改用轻量替代：在
settings.json中加一行"csharp.omnisharpUsesGlobalMono": "never"，强制走内置精简模式（功能受限但能跑通基础using分析）
离线批量部署时，如何避免每个机器都手动配 CodeMaid 规则？
靠复制 settings.json 不可靠——不同开发机的路径、字体、缩进习惯可能不同，硬覆盖易引发冲突。更稳的方式是用“用户设置 + 工作区覆盖”两级结构。
操作要点：
- 在每台机器的
%APPDATA%\Code\User\settings.json里只保留通用开关，例如："codemaid.runOnSave"、"codemaid.sortUsings" - 把语言专属规则（如 C# 成员排序顺序、空白行策略）写进项目根目录的
.vscode\settings.json，随代码库 Git 管理 - 禁用所有带
codemaid.*.path的路径类配置项（如codemaid.customRulesPath），这类路径在离线机上极易指向不存在的位置，反而导致插件初始化失败
真正难处理的是插件自己生成的临时缓存文件，比如 %TEMP%\codemaid-*，它们不会随设置同步，但积累多了会影响响应速度——建议每月执行一次 del /s /q "%TEMP%\codemaid-*"。
