Qué no confirmar

Cuando colocas el código fuente de Dart en un repositorio (usando la herramienta pub, GitHub u otro sistema de gestión de código fuente), no incluyas la mayoría de los archivos que generan tu IDE o editor de código, la herramienta pub y otras herramientas.

No registres (commit) los siguientes archivos y directorios creados por pub:

.dart_tool/
build/
pubspec.lock  # Except for application packages

No registres el directorio de documentación de la API creado por dart doc:

doc/api/

No registres archivos y directorios creados por otros entornos de desarrollo. Por ejemplo, si tu entorno de desarrollo crea cualquiera de los siguientes archivos, considera colocarlos en un archivo de exclusión global:

# IntelliJ
*.iml
*.ipr
*.iws
.idea/

# Mac
.DS_Store

Para más detalles, sigue leyendo.

Como regla general, registra únicamente los archivos que las personas necesitan para usar tu paquete o repositorio de código fuente. Incluir archivos adicionales es innecesario, podría ser contraproducente y podría tener implicaciones de seguridad si expones detalles sobre la configuración de tu máquina. En muchos repositorios de código fuente, la práctica común es no registrar archivos generados en absoluto.

Para evitar registrar archivos que son específicos de tu flujo de trabajo o configuración personal, considera usar un archivo de exclusión global (por ejemplo, .gitignore_global).

Cuando usas pub dentro de un repositorio de Git, pub ignora los mismos archivos que Git. Por ejemplo, si ejecutas pub publish desde un repositorio de Git que tiene un archivo .gitignore que contiene keys.txt, entonces tu paquete publicado no contendrá el archivo keys.txt.

Para obtener más información sobre los archivos .gitignore, consulta la página de ayuda de GitHub Cómo ignorar archivos (Ignoring files).

El directorio .dart_tool/ contiene archivos utilizados por varias herramientas de Dart.

El archivo pubspec.lock es un caso especial, similar a Gemfile.lock de Ruby.

Para paquetes normales, no registres (commit) el archivo pubspec.lock. Regenerar el archivo pubspec.lock te permite probar tu paquete contra las últimas versiones compatibles de sus dependencias.

Para paquetes de aplicación, recomendamos que registres el archivo pubspec.lock. Llevar el control de versiones del archivo pubspec.lock garantiza que los cambios en las dependencias transitivas sean explícitos. Cada vez que las dependencias cambien debido a dart pub upgrade o a un cambio en pubspec.yaml la diferencia será evidente en el archivo de bloqueo.