vscode插件开发中中文路径读取失败的典型表现是fs.readfile或findfiles返回enoent或空数组，根本原因是node.js子进程默认c locale无法解析utf-8路径；必须在插件入口顶部设置process.env.lc_all='zh_cn.utf-8'，且须早于任何路径api调用。

VSCode插件开发中中文路径读取失败的典型表现

你在插件里用 fs.readFile 或 vscode.workspace.findFiles 读取含中文的文件路径时，返回 ENOENT 或空数组，但实际文件存在、路径肉眼可见——这不是编码错误，而是 VS Code 启动时未正确传递系统 locale，导致 Node.js 子进程默认使用 C locale，无法解析 UTF-8 路径。

必须在 main.js 入口前设置 process.env.LC_ALL

VS Code 插件运行在独立的 Electron 渲染进程中，其 Node.js 环境不继承系统语言环境。即使用户系统是中文 Windows/macOS，process.env.LC_ALL 默认为空或 C，会直接导致路径解析失败。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 在插件主模块（如 extension.js）最顶部添加：

process.env.LC_ALL = 'zh_CN.UTF-8';
// macOS 可用 'zh_CN.UTF-8' 或 'UTF-8'；Windows 推荐 'Chinese_China.936'（但兼容性差），优先走 UTF-8 路径

• 该设置必须在任何 fs、path 或工作区 API 调用之前执行，否则已缓存的路径行为不可逆
• 不要依赖 os.locale 或 vscode.env.language —— 它们只反映 UI 语言，不控制底层文件系统行为

vscode.workspace.findFiles 对中文路径的隐式限制

vscode.workspace.findFiles 在 Windows 和 Linux 下对中文支持良好，但在 macOS 上若工作区根路径含中文，且未显式指定 exclude，可能因 glob 引擎底层编码问题漏匹配。这不是 bug，是 Node.js glob 模块与 macOS 文件系统交互的历史遗留。

• 强制指定 include 模式并启用 useIgnoreFiles: false
• 避免用 ** 深层通配，改用明确层级，例如 src/**/!(*.test).ts 比 **/*.ts 更稳定
• 调试时用 vscode.workspace.rootPath 打印实际路径，确认是否被截断或乱码（乱码即说明 LC_ALL 未生效）

调试器 launch.json 中中文路径的坑

当你在插件开发中用调试模式启动另一个 VS Code 实例（如 "type": "extensionHost"），被调试实例若打开含中文路径的工作区，断点可能无法命中——因为 sourcemap 路径解析失败。

• 在 .vscode/launch.json 的配置中，添加 "env": { "LC_ALL": "zh_CN.UTF-8" }
• 确保被调试实例的 settings.json 中没有禁用 files.autoGuessEncoding（默认为 true，保持即可）
• 避免在 outFiles 字段中写死绝对中文路径；改用相对路径 + ${workspaceFolder} 变量

中文路径本身不是问题，问题是 VS Code 插件运行时环境默认剥离了 UTF-8 路径支持能力。所有路径操作前加一行 process.env.LC_ALL 设置，比后期排查乱码、空结果、断点失效要省力得多。