03点号隐藏文件与项目配置目录

在 Unix/Linux 系统中，文件名或文件夹名前加点 (.) 表示这是一个 隐藏文件 或 隐藏目录。这类文件通常用于存储配置、脚本或系统相关内容，默认情况下不会出现在普通文件列表中，除非显式指定显示隐藏文件。

1. 基本概念

• 隐藏文件/文件夹：在 Unix/Linux 中，以 . 开头的文件或文件夹默认不会显示在 ls 命令或文件管理器的普通视图中。
• 显示方式：使用 ls -a 或在图形界面启用“显示隐藏文件”选项即可查看。

2. 在项目中的典型用法

某些常见的隐藏文件夹在软件项目中具有特殊作用：

• .circleci：存放 CircleCI 的配置文件，用于定义持续集成与自动化测试流程。
• .github：与 GitHub 项目相关的元数据和配置，例如 Issue/PR 模板、GitHub Actions 工作流。
• .vscode：存放 Visual Studio Code 编辑器的工作区配置，例如格式化规则、扩展推荐。
• .dockerignore：用于指定哪些文件或目录在构建 Docker 镜像时应被忽略，类似 .gitignore。
• .gitignore / .gitattributes / .git：与 Git 版本控制相关的配置和元数据。

3. 为什么要隐藏这些文件夹？

1. 清晰的项目结构
   • 这些配置文件虽然关键，但不属于项目核心逻辑。隐藏后能让开发者更聚焦代码本身。
2. 避免误操作
   • 普通开发者无需频繁修改这些文件，隐藏它们可减少误删或误改的风险。
3. 约定俗成
   • 隐藏配置文件夹是 Unix/Linux 世界的惯例，开发工具与 CI 平台也遵循这一规范。

4. 示例

一个常见的项目目录结构：

my-project/
├── src/              # 项目源代码
├── tests/            # 测试代码
├── .github/          # GitHub Actions 配置
├── .vscode/          # VS Code 编辑器配置
├── .dockerignore     # Docker 忽略规则
├── .gitignore        # Git 忽略规则
└── README.md

5. 注意事项

• 在 Linux/MacOS 下默认隐藏，以点开头的文件在 Windows 系统中也通常被视为隐藏文件。
• 修改这些文件需谨慎，尤其是 CI/CD 配置和版本控制文件。
• 在多人协作的仓库中，.github、.circleci 等配置文件是团队协作流程的一部分。