不該提交什麼

當您將 Dart 原始碼放入儲存庫時—使用 pub 工具、GitHub 或其他原始碼管理系統—請勿包含 IDE 或程式碼編輯器、pub 工具和其他工具產生的大部分檔案。

請勿提交 pub 建立的下列檔案和目錄

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

請勿提交 dart doc 建立的 API 文件目錄

doc/api/

請勿提交其他開發環境建立的檔案和目錄。例如，如果您的開發環境建立下列任何檔案，請考慮將它們放入全域忽略檔案

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

# Mac
.DS_Store

如需更多詳細資訊，請繼續閱讀。

作為規則，僅提交人們需要使用您的套件或原始碼儲存庫的檔案。包含其他檔案是不必要的，可能會有反效果，如果您暴露有關您機器設定的詳細資訊，則可能會有安全性隱含。在許多原始碼儲存庫中，常見的做法是完全不提交產生的檔案。

為了避免提交特定於您的個人工作流程或設定的檔案，請考慮使用全域忽略檔案 (例如，.gitignore_global)。

當您從 Git 儲存庫中使用 pub 時，pub 會忽略 Git 忽略的相同檔案。例如，如果您從具有包含 keys.txt 的 .gitignore 檔案的 Git 儲存庫執行 pub publish，則您發布的套件將不會包含 keys.txt 檔案。

如需 .gitignore 檔案的更多資訊，請參閱 GitHub 說明頁面 忽略檔案。

.dart_tool/ 目錄包含各種 Dart 工具使用的檔案。

pubspec.lock 檔案是一種特殊情況，類似於 Ruby 的 Gemfile.lock。

對於常規套件，請勿提交 pubspec.lock 檔案。重新產生 pubspec.lock 檔案可讓您針對其相依性的最新相容版本測試您的套件。

對於應用程式套件，我們建議您提交 pubspec.lock 檔案。對 pubspec.lock 檔案進行版本控制可確保對可轉移相依性的變更是明確的。每次由於 dart pub upgrade 或 pubspec.yaml 中的變更而導致相依性變更時，差異將在鎖定檔案中顯而易見。

除非另有說明，否則本網站上的文件反映 Dart 3.7.1 版本。頁面最後更新於 2024-12-10。 查看原始碼 或 回報問題。