告别幽灵依赖与磁盘焦虑：pnpm 硬链接

const fs = require('fs')
const path = require('path')
const os = require('os')

// 在系统临时目录建一个普通文件，用于 stat
const file = path.join(os.tmpdir(), `inode-demo-${Date.now()}.txt`)
fs.writeFileSync(file, 'hello', 'utf8')
const s = fs.statSync(file)

/*
 * s.ino：这个文件的 inode 编号，一个整数（就是下面要打印的数）。
 * 运行后终端大致会长这样（数字仅举例，你电脑上会是别的数）：
 *   ino (inode 编号): 14023456789012345
 */
console.log('ino (inode 编号):', s.ino)

fs.unlinkSync(file)

const fs = require('fs')
const path = require('path')
const os = require('os')

const dir = path.join(os.tmpdir(), `hardlink-demo-${Date.now()}`)
fs.mkdirSync(dir, { recursive: true })
const store = path.join(dir, 'store.txt') // 类比 pnpm store 里的唯一文件
const app = path.join(dir, 'app.txt') // 类比项目 node_modules 里出现的「第二名字」
fs.writeFileSync(store, 'A', 'utf8')
fs.linkSync(store, app) // 硬链：app 与 store 指向同一 inode

const ss = fs.statSync(store)
const sa = fs.statSync(app)
console.log('硬链后 ino 相同:', ss.ino === sa.ino) // true：两个路径是同一份物理文件
console.log('硬链后 nlink:', ss.nlink) // 2：两个名字都计入该 inode

fs.writeFileSync(store, 'B', 'utf8') // 改其中任意一个名字，另一处读到同一块数据
console.log('改 store 后读 app:', fs.readFileSync(app, 'utf8')) // B

fs.rmSync(dir, { recursive: true, force: true })

const fs = require('fs')
const path = require('path')
const os = require('os')

const dir = path.join(os.tmpdir(), `symlink-demo-${Date.now()}`)
fs.mkdirSync(dir, { recursive: true })
const target = path.join(dir, 'target.txt')
const alias = path.join(dir, 'alias.txt')
fs.writeFileSync(target, 'real', 'utf8')
fs.symlinkSync(target, alias) // 软链：alias 指向 target 的路径（Windows 下若失败，可尝试管理员/开发者模式）

const stFollow = fs.statSync(alias) // 跟随：得到「目标文件」的 inode
const stLink = fs.lstatSync(alias) // 不跟随：得到「链接本身」的 inode
console.log('lstat isSymbolicLink:', stLink.isSymbolicLink()) // true：这是软链，不是普通文件
console.log('readlink 存的路径:', fs.readlinkSync(alias)) // 与硬链不同：链上存的是字符串路径
console.log('软链自身 ino !== 跟随后的 ino:', stLink.ino !== stFollow.ino) // 通常为 true：两个 inode

fs.rmSync(dir, { recursive: true, force: true })

const fs = require('fs')
const { join, dirname } = require('path')

// 输出目录：与脚本同级的 .demo-out/
const root = join(__dirname, '.demo-out')

/**
 * 将 store 中的已有文件硬链到「安装路径」。
 * 类比 pnpm：store 里唯一内容，项目 node_modules 里多出的名字指向同一 inode。
 */
function hardLinkFile(from, to) {
  fs.mkdirSync(dirname(to), { recursive: true })
  fs.linkSync(from, to) // 为已有文件增加硬链接（须在同一文件系统内）
}

function main() {
  fs.rmSync(root, { recursive: true, force: true })
  const storePkg = join(root, 'store', 'lodash@4.0.0', 'index.js')
  fs.mkdirSync(dirname(storePkg), { recursive: true })
  fs.writeFileSync(storePkg, "module.exports = { tag: 'from-store' }\n", 'utf8')

  const app1 = join(root, 'app-a', 'node_modules', 'lodash', 'index.js')
  const app2 = join(root, 'app-b', 'node_modules', 'lodash', 'index.js')
  hardLinkFile(storePkg, app1)
  hardLinkFile(storePkg, app2)

  const sStore = fs.statSync(storePkg)
  const s1 = fs.statSync(app1)
  const s2 = fs.statSync(app2)

  // ino 相同 → 三处路径共享同一 inode，即同一份物理文件
  console.log('同一物理文件（硬链）:', sStore.ino === s1.ino && s1.ino === s2.ino)
  // nlink：指向该 inode 的硬链接条数（含 store 路径本身）
  console.log('nlink（硬链计数）:', sStore.nlink)

  fs.writeFileSync(storePkg, "module.exports = { tag: 'mutated-in-store' }\n", 'utf8')
  // 改 store 即改 inode 上的数据，所有硬链名立即可见
  console.log('改 store 后 app-a 读到:', fs.readFileSync(app1, 'utf8').trim())
}

try {
  main()
} catch (e) {
  console.error(e)
  process.exit(1)
}

node hardlink-demo.cjs

my-app/
  package.json          # dependencies 里只写了 "foo"
  node_modules/
    foo/
    bar/                # ← foo 依赖 bar，被提升/摊平到顶层
    # 你的代码在 my-app 里写 require('bar')：
    # 解析器在 my-app/node_modules 就找到了 bar —— 「碰巧能跑」

packages:
  - 'packages/*'

{
  "name": "phantom-workspace-demo",
  "private": true,
  "scripts": {
    "demo:phantom": "node packages/consumer/entry.js",
    "demo:fixed": "node packages/consumer-fixed/entry.js"
  }
}

{
  "name": "bar",
  "version": "1.0.0",
  "main": "index.js"
}

exports.value = 'bar'

{
  "name": "foo",
  "version": "1.0.0",
  "main": "index.js",
  "dependencies": {
    "bar": "workspace:*"
  }
}

const { value } = require('bar')
exports.fooUses = value

{
  "name": "consumer",
  "version": "1.0.0",
  "dependencies": {
    "foo": "workspace:*"
  }
}

/**
 * 仅声明依赖 foo，却直接 require 传递依赖 bar。
 * 在扁平 node_modules 下可能「碰巧能跑」；
 * 在 pnpm 严格布局下应解析失败（无幽灵依赖）。
 */
const { fooUses } = require('foo')
const { value } = require('bar')

console.log('foo', fooUses, 'bar', value)

{
  "name": "consumer-fixed",
  "version": "1.0.0",
  "dependencies": {
    "foo": "workspace:*",
    "bar": "workspace:*"
  }
}

const { fooUses } = require('foo')
const { value } = require('bar')

console.log('ok:', fooUses, value)

pnpm install
pnpm demo:phantom   # 预期：Cannot find module 'bar'
pnpm demo:fixed     # 预期：终端输出 ok: bar bar