feat(tools): junction.mjs 跨平台目录链接创建/检测

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-28 12:07:40 +08:00
co-authored by Claude Opus 4.8
parent e7e9406c48
commit 5ef65c0d05
2 changed files with 79 additions and 0 deletions
@@ -0,0 +1,29 @@
import { symlinkSync, lstatSync, existsSync } from 'node:fs';
import { resolve } from 'node:path';
import { platform } from 'node:process';
// Windows 用 junction(免管理员、仅限目录);其它平台用 dir 符号链接
const LINK_TYPE = platform === 'win32' ? 'junction' : 'dir';
export function isLink(p) {
try {
return lstatSync(p).isSymbolicLink();
} catch {
return false;
}
}
// 在 linkPath 建一个指向 targetPath 的目录链接。
// 返回 'created' | 'exists';目标不存在或 linkPath 已被真实文件占用则抛错。
export function ensureJunction(linkPath, targetPath) {
const target = resolve(targetPath); // junction 要求绝对目标
if (!existsSync(target)) {
throw new Error(`junction target 不存在: ${target}`);
}
if (isLink(linkPath)) return 'exists';
if (existsSync(linkPath)) {
throw new Error(`路径已存在且非链接,拒绝覆盖: ${linkPath}`);
}
symlinkSync(target, linkPath, LINK_TYPE);
return 'created';
}