cangjie-fs

仓颉语言文件系统 Skill

1. File 类

• 来自 std.fs.*
• 实现 Resource & IOStream & Seekable
• 构造：File(path, OpenMode) 或 File(Path, OpenMode)

• 静态方法：

• 使用 try-with-resource 自动关闭

import std.fs.*
import std.io.*

main() {
    let path = Path("./demo.txt")

    // 写入文件
    try (f = File(path, Write)) {
        f.write("Hello 仓颉\n".toArray())
    }

    // 追加
    File.appendTo(path, "第二行\n".toArray())

    // 读取整个文件
    let data = File.readFrom(path)
    println(String.fromUtf8(data))

    // 随机读取
    try (f = File(path, Read)) {
        f.seek(SeekPosition.Begin(6))
        let buf = Array<Byte>(6, repeat: 0)
        f.read(buf)
        println(String.fromUtf8(buf))
    }

    remove(path)
}

2. 文件系统函数

3. Directory 操作

import std.fs.*

main() {
    let dir = Path("./mydir/sub")
    Directory.create(dir, recursive: true)

    File.create(dir.join("test.txt")).close()

    let entries = Directory.readFrom(Path("./mydir"))
    for (e in entries) {
        println("${e.name} - ${e.size} bytes")
    }

    remove(Path("./mydir"), recursive: true)
}

4. Path 操作

• Path 是路径结构体，支持路径拼接和解析
• 关键属性：parent、fileName、extensionName、fileNameWithoutExtension、isAbsolute()
• path.join(subPath) — 拼接子路径
• canonicalize(path) — 解析为绝对规范路径（处理 .、..、符号链接）

import std.fs.*

main() {
    let p = Path("/home/user/docs/readme.md")
    println(p.parent)                     // "/home/user/docs"
    println(p.fileName)                   // "readme.md"
    println(p.extensionName)              // "md"
    println(p.fileNameWithoutExtension)   // "readme"
    println(p.isAbsolute())               // true
    println(p.join("../notes"))           // "/home/user/docs/readme.md/../notes"
    println(canonicalize(Path(".")))      // 当前目录的绝对路径
}

5. FileInfo

• 通过 File.info 或 Directory.readFrom() 获取
• 属性：name、path、size、creationTime、lastAccessTime、lastModificationTime、parentDirectory
• 注意：每次访问属性都从文件系统实时获取，注意并发竞态

6. 异常类型

7. 关键规则速查

1. 文件使用 try-with-resource 自动关闭
2. File.readFrom / File.writeTo / File.appendTo 是便捷的一次性读写方法
3. FileInfo 每次属性访问都是实时文件系统查询，注意并发竞态
4. Directory.create 需要 recursive: true 才能递归创建多级目录
5. remove 删除目录时需要 recursive: true