DuckDB 会在磁盘上创建若干文件和目录。本页面列出了全局文件和本地文件。

全局文件和目录

DuckDB 会在用户主目录（记作 ~）中创建以下全局文件和目录

位置	描述	版本间共享	客户端间共享
~/.duckdbrc	启动 DuckDB CLI 客户端时会执行此文件的内容。其中的命令既可以是 点命令 (dot command)，也可以是 SQL 语句。此文件的命名方式参考了 ~/.bashrc 和 ~/.zshrc 等“运行命令”文件。	是	仅由 CLI 使用
~/.duckdb_history	历史记录文件，类似于 ~/.bash_history 和 ~/.zsh_history。由 DuckDB CLI 客户端使用。	是	仅由 CLI 使用
~/.duckdb/extensions	已安装 扩展 的二进制文件。	否	是
~/.duckdb/stored_secrets	由 Secrets 管理器 创建的 持久化密钥。	是	是

本地文件和目录

DuckDB 在工作目录（针对内存连接）或数据库文件所在目录（针对持久化连接）中创建以下文件和目录

名称	描述	示例
database_filename	数据库文件。仅在磁盘模式下创建。该文件可以使用任何扩展名，常见的有 .duckdb、.db 和 .ddb。	weather.duckdb
.tmp/	临时目录。仅在内存模式下创建。	.tmp/
database_filename.tmp/	临时目录。仅在磁盘模式下创建。	weather.tmp/
database_filename.wal	预写式日志 (Write-ahead log) 文件。如果 DuckDB 正常退出，WAL 文件会在退出时被删除。如果 DuckDB 崩溃，则需要通过 WAL 文件来恢复数据。	weather.wal

如果您正在 Git 仓库中工作，并希望阻止 Git 追踪这些文件，请参阅关于使用 .gitignore for DuckDB 的说明。