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

全局文件和目录

DuckDB 在用户主目录（用 ~ 表示）中创建以下全局文件和目录：

位置	描述	版本间共享	客户端间共享
~/.duckdbrc	当启动 DuckDB CLI 客户端时，此文件的内容会被执行。命令可以是 点命令，也可以是 SQL 语句。此文件的命名遵循 ~/.bashrc 和 ~/.zshrc “运行命令”文件。	是	仅限 CLI 使用
~/.duckdb_history	历史文件，类似于 ~/.bash_history 和 ~/.zsh_history。由 DuckDB CLI 客户端使用。	是	仅限 CLI 使用
~/.duckdb/extensions	已安装的 扩展 的二进制文件。	否	是
~/.duckdb/stored_secrets	由 密钥管理器 创建的 持久密钥。	是	是

本地文件和目录

DuckDB 在工作目录（对于内存连接）或相对于数据库文件（对于持久连接）创建以下文件和目录：

名称	描述	示例
数据库文件名	数据库文件。仅在磁盘模式下创建。文件可以有任何扩展名，常见的扩展名有 .duckdb、.db 和 .ddb。	weather.duckdb
.tmp/	临时目录。仅在内存模式下创建。	.tmp/
database_filename.tmp/	临时目录。仅在磁盘模式下创建。	weather.tmp/
database_filename.wal	预写式日志文件。如果 DuckDB 正常退出，WAL 文件在退出时删除。如果 DuckDB 崩溃，WAL 文件是恢复数据所必需的。	weather.wal

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