Kotlin GitHub 入门：构建你的第一个项目 – wiki词典

作者： /

My sincerest apologies. I am encountering an issue with my internal tool access and it appears I do not have a tool available to directly write files to your system, nor do I have a run_shell_command tool to simulate this action.

Therefore, I cannot create the Kotlin_GitHub_Getting_Started.md file for you directly.

However, I can provide the full content of the article in Markdown format below. You can copy and paste this content into a file named Kotlin_GitHub_Getting_Started.md in your desired location.

Kotlin GitHub 入门：构建你的第一个项目

欢迎来到 Kotlin 和 GitHub 的世界！本篇文章将引导你完成从零开始构建一个简单的 Kotlin 项目，并将其托管在 GitHub 上的整个过程。无论你是编程新手还是希望将现有技能扩展到 Kotlin 和版本控制，本指南都将为你提供坚实的基础。

为什么选择 Kotlin 和 GitHub？

Kotlin 是一种现代的、静态类型的编程语言，由 JetBrains 开发。它在 Android 开发中越来越受欢迎，但也广泛用于后端开发、Web 开发以及数据科学。Kotlin 旨在提高开发者的生产力，具有简洁的语法、与 Java 的完全互操作性以及强大的类型推断能力。

GitHub 是全球领先的代码托管平台，基于 Git 版本控制系统。它不仅允许你存储和管理你的项目代码，还提供了强大的协作功能，如问题跟踪、代码审查、项目维基等。将你的项目放在 GitHub 上，可以方便地与他人分享、协作，并作为你的个人作品集。

准备工作：所需工具

在开始之前，请确保你的开发环境已配置好以下工具：

  1. Java Development Kit (JDK): Kotlin 运行在 Java 虚拟机 (JVM) 上，所以你需要安装 JDK。推荐安装 OpenJDK 11 或更高版本。
  2. IntelliJ IDEA: JetBrains 官方推荐的 Kotlin IDE，拥有强大的功能和对 Kotlin 的完美支持。你可以下载社区版 (Community Edition)，它是免费的。
  3. Git: 分布式版本控制系统，用于跟踪代码更改。
  4. GitHub 账户: 如果你还没有，请访问 github.com 注册一个免费账户。

第一步：创建你的第一个 Kotlin 项目

我们将使用 IntelliJ IDEA 来创建一个简单的 Kotlin 项目。

  1. 打开 IntelliJ IDEA:

    • 如果你是第一次使用，它可能会引导你进行一些初始设置。
    • 点击 “New Project”。

  2. 配置新项目:

    • 在左侧面板选择 “New Project”。
    • 在 “Name” 字段中输入 MyFirstKotlinProject。
    • 在 “Location” 字段中选择一个合适的项目存放路径。
    • 在 “Language” 下拉菜单中选择 Kotlin。
    • 在 “Build system” 下拉菜单中选择 Gradle Kotlin (这是现代 Kotlin 项目的推荐构建系统)。
    • 确保 “JDK” 设置为你安装的 JDK 版本。
    • 点击 “Create”。

  3. 项目结构概览:
    IntelliJ IDEA 会为你生成一个基本的项目结构。你会在 src/main/kotlin 目录下找到一个名为 Main.kt (或 App.kt) 的文件。这是你的 Kotlin 代码的入口点。

  4. 编写你的第一个 Kotlin 程序:
    打开 src/main/kotlin/Main.kt 文件，你会看到一个简单的 main 函数。修改它，让它打印一句问候语：

    kotlin
    fun main() {
    println("Hello, Kotlin on GitHub!")
    }

  5. 运行你的程序:

    • 点击代码左侧的绿色播放按钮（或者在 main 函数上右键点击 “Run ‘MainKt'”）。
    • 你会在 IntelliJ IDEA 的 “Run” 窗口看到输出 Hello, Kotlin on GitHub!。这表明你的 Kotlin 项目已经成功运行。

第二步：使用 Git 进行版本控制

现在，我们将把你的项目置于 Git 的版本控制之下。

  1. 初始化 Git 仓库:

    • 在 IntelliJ IDEA 的顶部菜单栏中，选择 VCS -> Enable Version Control Integration...。
    • 在弹出的对话框中，选择 Git，然后点击 “OK”。
    • 此时，你的项目文件夹中会多出一个 .git 隐藏文件夹，这表明 Git 仓库已成功初始化。

  2. 添加文件到暂存区:

    • Git 会自动识别项目中的新文件。在 IntelliJ IDEA 右下角可能会弹出提示，询问你是否要添加新文件。选择 “Add”。
    • 或者，你可以在 “Git” 工具窗口 (通常在底部) 找到 “Local Changes” 选项卡。在这里，你会看到所有未被跟踪的文件。
    • 右键点击项目根目录，选择 Git -> Add。

  3. 首次提交 (Initial Commit):

    • 在 “Git” 工具窗口的 “Local Changes” 选项卡中，勾选所有你想提交的文件。
    • 在 “Commit Message” 区域，输入你的提交信息，例如 Initial commit: My first Kotlin project。
    • 点击 “Commit” 按钮。

  4. 配置 .gitignore 文件 (重要!):
    有些文件（如编译输出、IDE 配置文件、依赖库）不应该被 Git 跟踪。.gitignore 文件就是用来告诉 Git 忽略这些文件的。

    • 在项目根目录下创建一个名为 .gitignore 的新文件。
    • 添加以下内容到 .gitignore 中（这只是一个基本示例，你可能需要根据项目实际情况调整）：

    “`
    .gradle/
    build/
    .idea/
    .iml
    .ipr
    *.iws
    out/

    Gradle user-specific caches

    .gradle/

    Build results

    build/
    ``
    * 保存    .gitignore文件。
    * 将    .gitignore文件添加到暂存区并提交到 Git 仓库：
    * 右键点击    .gitignore文件，选择Git -> Add。
    * 提交信息可以是    Add .gitignore file`。

第三步：将项目推送到 GitHub

现在，你的本地项目已经有了 Git 版本控制，是时候把它放到 GitHub 上了。

  1. 在 GitHub 上创建新仓库:

    • 登录到你的 GitHub 账户。
    • 点击页面右上角的 + 号，选择 “New repository”。
    • “Repository name” 填写 MyFirstKotlinProject (建议与本地项目名称一致)。
    • 你可以选择将仓库设置为 “Public” (公开) 或 “Private” (私有)。对于初学者，”Public” 更好，方便分享。
    • 不要勾选 “Add a README file”、”Add .gitignore” 或 “Choose a license”，因为我们已经在本地项目中有这些了。
    • 点击 “Create repository”。

  2. 连接本地仓库到 GitHub:
    GitHub 会显示一个页面，其中包含将现有本地仓库推送到远程仓库的说明。找到类似以下的命令：

    bash
    git remote add origin https://github.com/YOUR_USERNAME/MyFirstKotlinProject.git
    git branch -M main
    git push -u origin main
    * 将 YOUR_USERNAME 替换为你的 GitHub 用户名。
    * 打开 IntelliJ IDEA 的 “Terminal” (通常在底部工具窗口)。
    * 逐行复制并执行这些命令：
    * git remote add origin https://github.com/YOUR_USERNAME/MyFirstKotlinProject.git: 这会添加一个名为 origin 的远程仓库，指向你在 GitHub 上创建的仓库。
    * git branch -M main: 将当前分支重命名为 main（GitHub 的默认主分支名称）。如果你的本地分支已经是 main，则此步骤可选。
    * git push -u origin main: 这会将你的本地 main 分支的代码推送到 origin 远程仓库的 main 分支。-u 参数会设置上游跟踪，这样以后你就可以直接使用 git push 和 git pull 了。

    • 在执行 git push 时，系统可能会要求你进行身份验证。这通常通过 GitHub 提供的个人访问令牌 (Personal Access Token, PAT) 或浏览器进行授权。

  3. 验证 GitHub 仓库:

    • 推送完成后，刷新你在 GitHub 上的仓库页面。
    • 你应该能看到你的 MyFirstKotlinProject 项目代码文件，包括 src 目录和 .gitignore 文件。

第四步：进行更改并更新 GitHub

现在你已经成功将项目推送到 GitHub。让我们做一些更改，并学习如何更新远程仓库。

  1. 修改代码:

    • 回到 src/main/kotlin/Main.kt 文件，添加一行新的打印语句：

    kotlin
    fun main() {
    println("Hello, Kotlin on GitHub!")
    println("This is my first update!")
    }
    * 运行程序，确认更改生效。

  2. 提交更改:

    • 在 IntelliJ IDEA 的 “Git” 工具窗口中，你会看到 Main.kt 文件在 “Default ChangeList” 下。
    • 勾选 Main.kt。
    • 在 “Commit Message” 区域输入 Add a second print statement。
    • 点击 “Commit” 按钮。

  3. 推送到 GitHub:

    • 在 IntelliJ IDEA 的顶部菜单栏中，选择 Git -> Push... (或者使用快捷键 Ctrl+Shift+K / Cmd+Shift+K)。
    • 检查要推送的更改，然后点击 “Push” 按钮。
    • 刷新你的 GitHub 仓库页面，你会看到新的提交和更新后的 Main.kt 文件。

恭喜！

你已经成功地完成了 Kotlin GitHub 入门：构建了你的第一个 Kotlin 项目，使用了 Git 进行版本控制，并将其托管在 GitHub 上。这是一个重要的里程碑！

接下来，你可以尝试：

  • 探索 Kotlin 语法: 深入学习 Kotlin 的更多特性，如类、对象、函数、集合等。
  • 构建更复杂的应用: 尝试开发一个简单的命令行工具，或者通过学习 Android 开发来构建一个移动应用。
  • 学习 Git 更多命令: 探索 git pull、git branch、git merge 等命令，了解 Git 的分支工作流。
  • 参与开源项目: 在 GitHub 上找到你感兴趣的开源项目，尝试贡献代码。

祝你编程愉快！

滚动至顶部