必须用 os.path.islink() 判断软链接，因为它只检测路径自身是否为符号链接，不追踪目标，即使目标不存在或损坏也返回 True；而 isfile()/isdir() 会跟随链接检查目标类型。
用 os.path.islink() 专门检测软链接
软链接（symbolic link）和普通文件在磁盘上是不同类型的对象，不能靠 os.path.isfile() 或 os.path.isdir() 判断是否为软链接——它们对软链接返回的是其**指向目标**的类型，不是链接本身。真正判断“这个路径是不是一个软链接”，必须用 os.path.islink()。
它只关心路径自身是否为符号链接，不追踪、不解析目标，所以即使目标不存在、损坏或权限不足，只要链接文件本身存在且是 symlink，就返回 True。
-
os.path.islink("broken_link")→True（即使它指向一个已删除的文件） -
os.path.islink("regular_file.txt")→False -
os.path.islink("valid_symlink")→True（无论目标是否可访问）
区分“软链接”和“软链接指向的文件”
很多误判来自混淆了“链接本身”和“链接所指”。比如你执行 os.path.isfile("mylink")，Python 默认会跟随软链接去检查目标；若目标是个普通文件，就返回 True，但这不代表 "mylink" 是文件——它只是个指向文件的链接。
要严格按路径实体类型判断，得组合使用：
立即学习“Python免费学习笔记（深入）”；
- 是软链接？→
os.path.islink(path) - 是普通文件（且非软链接）？→
os.path.isfile(path) and not os.path.islink(path) - 是目录（且非软链接）？→
os.path.isdir(path) and not os.path.islink(path)
注意：Windows 上从 Python 3.8 起支持软链接（需管理员权限创建），os.path.islink() 在该平台也生效；旧版本或受限环境可能始终返回 False。
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
用 pathlib 更清晰地表达意图
如果你用的是 Python 3.4+，pathlib.Path 的 API 更直观，语义更明确：
from pathlib import Path
p = Path("some_path")
<p>p.is_symlink() # 对应 os.path.islink()
p.is_file() # 不跟随软链接（默认行为，等价于 os.path.isfile() + not islink）
p.resolve(strict=False).is_file() # 显式解析后判断目标（strict=False 容忍 broken link）
p.is_file() 和 p.is_dir() 默认不跟随软链接——这点和 os.path 系列函数不同，反而更安全。但要注意：p.is_file() 对软链接本身返回 False，符合“它不是文件，它是个链接”的直觉。
常见错误：用 stat() 时没处理 ENOENT 或权限问题
有人想通过 os.stat() 的 st_mode 手动判断，但直接调用会因软链接目标不可达而抛 FileNotFoundError 或 PermissionError。正确做法是用 os.lstat() ——它读取链接自身的元数据，不跟随：
-
os.lstat(path).st_mode & stat.S_IFLNK→ 非零表示是软链接 -
os.stat(path)→ 可能失败，除非你明确想检查目标是否存在且可访问
不过，除非你在写底层工具或需要额外 inode 信息，否则没必要绕开 os.path.islink() 或 Path.is_symlink() 去手动位运算。
真正容易被忽略的是：软链接可以嵌套（链接指向另一个链接），而 islink() 只回答“当前这层是不是链接”，不递归。如果你需要知道“最终指向什么”，得自己循环 os.readlink() 或用 Path.resolve()，但那已是另一类需求了。
