TypeScript项目的.gitignore文件应排除哪些文件夹和文件？

核心结论 #

/src目录绝对不能加入.gitignore

具体理由 #

Git的核心作用是管控项目的可编辑原始资源，/src是你存放TS核心源码的目录，是所有编译产出（也就是/dist下的文件）的唯一来源。如果将其加入忽略列表，你的代码仓库将丢失最核心的开发资产：

• 其他协作者克隆仓库后无法拿到源码，无法进行二次开发、问题修复
• 你自己更换设备、回溯历史版本时也拿不到对应版本的源码，完全失去了版本管控的意义

对应你的项目结构的最优.gitignore配置逻辑 #

必须纳入忽略的目录 #

• /node_modules：依赖安装生成的目录，所有人执行包管理命令即可生成，无需提交，你当前的配置是正确的
• /dist：编译生成的.js、.d.ts都是基于源码输出的产物，每次构建都会重新生成，普通项目无需提交
• /test：按需选择是否忽略，如果你的测试文件是项目正式的单测、集成测用例，建议不要忽略，方便统一维护、做CI自动校验；如果都是你本地临时调试的测试代码，可以保留忽略配置

绝对不能忽略的目录 #

• /src：核心源码，必须全程纳入版本管控

示例.gitignore配置 #

# 依赖目录
node_modules/

# 编译产物目录
dist/

# 本地临时测试文件（正式用例请删除该行）
test/

# 其他通用忽略项
*.log
.vscode/
.idea/
.DS_Store

内容的提问来源于stack exchange，提问作者Heyyy Marco