Auto-sync: 2026-04-22 04:02

wiki/concepts/symbolic-link.md

@@ -0,0 +1,85 @@
+# Symbolic Link（符号链接）
+
+> Unix/Linux/macOS 文件系统中的一种特殊文件类型，指向另一个文件或目录的路径别名。
+
+## Overview
+
+Symbolic Link（符号链接，简称 symlink）是文件系统中的一个特殊条目，它存储的是目标路径字符串，而非实际数据。访问符号链接时，操作系统自动将其解析为实际目标路径。符号链接可用于解决以下问题：
+- 将隐藏目录映射为可见路径（如 `~/.openclaw` → `~/openclaw`）
+- 为长路径或版本化目录创建稳定引用（如 `/opt/frp/current` → 版本目录）
+- 跨文件系统创建文件引用
+
+## Core Properties
+
+| 属性 | 说明 |
+|------|------|
+| 类型 | 特殊文件（ln -s 创建） |
+| 存储内容 | 目标路径字符串（文本） |
+| 跨文件系统 | ✅ 支持（记录路径，不记录 inode） |
+| 删除行为 | 删除链接本身，不影响目标 |
+| 相对路径 | 可使用（相对当前链接位置解析） |
+| 绝对路径 | 推荐使用（避免歧义） |
+
+## Common Commands
+
+```bash
+# 创建符号链接
+ln -s /source/path /link/path          # 相对路径源
+ln -s /absolute/source /absolute/link  # 绝对路径源
+
+# 验证链接
+ls -la ~ | grep linkname                # 查看链接关系
+readlink ~/linkname                     # 查看指向目标
+
+# 删除符号链接（不会删除目标）
+rm ~/linkname
+
+# 替换已有链接（-n 处理链接本身是目录的情况）
+ln -sfn /new/target /link/path
+```
+
+## Use Cases
+
+### 1. 隐藏目录可见性映射
+将 OpenClaw 的 `~/.openclaw` 隐藏目录映射为 `~/openclaw`，使 Obsidian 可直接作为 Vault 访问。
+```
+~/.openclaw  →  ~/openclaw  (符号链接)
+```
+
+### 2. 版本管理（软链接策略）
+使用 `current` 符号链接指向当前激活的版本目录，简化启动命令并实现无缝升级/回滚。
+```
+/opt/frp/
+├── frp_0.65.0_darwin_arm64/
+├── frp_0.66.0_darwin_arm64/
+└── current → frp_0.66.0_darwin_arm64/
+```
+
+### 3. Git 友好目录结构
+将实际数据目录放在 Git 可管理的位置，再创建指向它的符号链接。
+
+## Symbolic Link vs Hard Link
+
+| 对比 | Symbolic Link | Hard Link |
+|------|--------------|-----------|
+| 跨文件系统 | ✅ 支持 | ❌ 不支持 |
+| 指向目录 | ✅ 支持 | ❌ 不支持（Unix） |
+| 删除目标 | 链接失效 | 仍可访问（引用计数>1） |
+| 存储内容 | 路径字符串 | inode 引用 |
+| 适用场景 | 路径别名、跨分区 | 同分区文件别名 |
+
+## Key Risks
+
+| 风险 | 说明 | 防范 |
+|------|------|------|
+| 目标不存在 | 链接成为悬空链接（dangling link） | 删除前确认无其他链接依赖 |
+| 误删 `rm -rf` | 当链接指向目录时，`rm` 链接本身是安全的 | 不要对目录链接使用 `-rf` |
+| 循环链接 | 链接指向自身或形成环 | 使用 `find -L` 或 `readlink -f` 展开 |
+
+## Related
+
+- [[软链接策略]] — Symbolic Link 在软件版本管理中的应用
+- [[Obsidian]] — Symbolic Link 的典型使用场景（Vault 映射）
+- [[OpenClaw]] — Symbolic Link 的操作对象（隐藏目录可见化）
+- [[frp]] — 软链接策略的典型应用
+- [[launchd]] — 使用软链接路径的服务管理