不能直接用 require('child_process') 调 git pull，因为 git pull 默认交互式处理凭证和冲突，而 node 子进程无 tty 环境且未配置 credential helper；需显式禁用交互（-c core.askpass= -c credential.helper=）、指定非交互合并策略（--ff-only）并传入绝对 cwd 路径。
为什么不能直接用 require('child_process') 调 git pull
很多人一上来就写 exec('git pull')，结果在 VSCode 终端里能跑，但一放到插件或任务脚本里就卡住、没输出、甚至报 Command failed: git pull。根本原因是：git pull 默认会尝试交互式处理冲突或凭证（比如弹出用户名/密码框），而 Node 的子进程默认不继承终端的 TTY 环境，也没配好 Git 的 credential helper。它不是“命令错了”，而是“环境缺了”。
必须显式配置 Git 的非交互行为
在调用前，得让 Git 明白：“别问我，按默认规则走”。关键参数就两个：
-
git -c core.askpass= -c credential.helper= pull：禁掉所有交互式凭证提示 - 加
--no-rebase或--ff-only避免合并策略引发意外暂停（尤其多人协作时） - 务必指定工作目录，
cwd不能靠process.cwd()猜——VSCode 插件可能在扩展目录执行，而不是你的项目根目录
示例代码片段：
const { exec } = require('child_process');
exec('git -c core.askpass= -c credential.helper= pull --ff-only', {
cwd: '/your/project/path' // 必须是绝对路径，可用 VSCode API 获取
}, (err, stdout, stderr) => {
if (err) console.error('Git pull failed:', stderr);
else console.log('Updated:', stdout);
});
在 VSCode 插件中安全获取项目根路径
用户可能打开的是多根工作区，或者只打开了一个文件夹下的子目录。直接读 __dirname 或 process.cwd() 会错。正确做法是依赖 VSCode 的 workspace API：
- 用
workspace.workspaceFolders判断是否为多根；单根时取folders[0].uri.fsPath - 如果用户没打开文件夹（只有文件），需 fallback 到该文件所在目录，用
workspace.textDocuments[0]?.uri?.fsPath+path.dirname() - 注意：路径末尾不能带斜杠，否则
cwd传给exec会失败（Node 会报spawn ENOENT）
自动拉取时机与防重入设计
想“保存时自动拉”或“聚焦窗口时自动拉”，必须加防抖和锁。Git 进程不是原子操作，连续触发两次 pull 极易导致 fatal: Unable to create '/xxx/.git/index.lock': File exists。
- 用布尔标志位
isPulling拦第一层并发 - 加
setTimeout防抖（比如 1.5s 内重复触发只执行最后一次） - 拉取完成后，检查
stdout是否含Already up to date或Updating xxx..xxx，别只看 err —— 成功更新和已是最新，业务处理逻辑往往不同
真正的麻烦点不在怎么写那行 exec，而在于你有没有处理好路径来源、Git 环境隔离、以及并发下的状态竞争。漏掉任意一环，它就会在某个用户某次切换分支后突然静默失败。
