跳至主要内容

在本地开发您的项目

了解如何通过构建一个基于 HTML、CSS 和 JavaScript 的示例客户端应用来创建本地开发环境。

概览

本地开发指的是在**您自己的电脑**上设置并运行项目,而不是在云端或远程服务器上。当您在本地开发时,可以在没有网络连接的情况下编写代码,并且可以进行实验而不会影响线上应用。

配置本地开发环境所需的步骤因项目而异,取决于其使用的编程语言、框架、工具和依赖。通过本指南,您将学习在一个基于 HTML、CSS 和 JavaScript 的示例客户端应用中所需的核心技能,从而能够为任何项目搭建环境,随后可将这些技能运用于其他项目。

安装必备的开发工具

在开始之前,您需要安装一些在本地开发中被广泛使用的必备工具。

  1. 使用 GitHub Copilot 设置 VS Code.
  2. 安装 Git.

克隆并在 VS Code 中打开仓库

首先,通过克隆来在您的电脑上复制仓库。

  1. 首先克隆 new2code/client-side-web-application 仓库。此链接将在 VS Code 中打开克隆对话框。
  2. 选择一个在电脑上保存仓库的位置,然后点击 选择为仓库目标
  3. 出现提示时,打开仓库。

安装项目需求

  1. 打开 Copilot Chat,然后使用以下提示让它帮您识别需要安装的内容。

    Text
    What do I need to install to develop this project locally? 
    

    在本示例中,Copilot 会告诉您该项目需要 Node.js。Node.js 让您可以在本地运行 JavaScript 代码,并提供 Web 开发所需的工具。

  2. 询问 Copilot 如何安装项目需求,然后按照步骤在电脑上完成安装。

    例如,您可以问 “如何安装 Node.js?” Copilot 将提供访问 https://node.org.cn/ 并下载安装程序的指引。

安装项目依赖

现在您已经安装了所需的软件,接下来需要了解如何在此项目中使用它们。

先查看 README 文件。大多数项目在根目录都有一个 README 文件,解释如何设置和运行项目。对于本项目,README 和向 Copilot 提问都会告诉您,下一步是使用 npm(Node.js 的包管理器)安装项目依赖。

  1. 按下 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(Mac)打开命令面板。

  2. 输入 Terminal: Create New Terminal 并按 Enter

  3. 在终端标签页中粘贴以下命令。

    Bash
    npm install
    

由于本项目使用 Node.js,我们使用 npm install 读取 package.json 文件并下载项目正常运行所需的所有依赖。其他类型的项目会使用不同的命令。例如,Python 项目可能使用 pip install -r requirements.txt,而 Ruby 项目可能使用 bundle install

如果 README 中未包含关于安装依赖的信息,您可以

  • 查找配置文件:不同的项目使用不同的文件列出依赖,例如 Node.js 项目使用 package.json,Python 项目使用 requirements.txt,Ruby 项目使用 Gemfile
  • 询问 Copilot:尝试使用类似 “我已经装好 Node.js,接下来应该怎么设置这个项目?” 的提示。

运行并开发您的项目

现在开发环境已经配置完毕,您可以启动开发服务器并使用它预览代码的更改。

  1. 通过查看项目文件夹中的 README 文件,了解如何启动项目。

    在本示例中,README 的 “本地运行步骤” 部分说明您可以使用 npm start 命令启动开发服务器。在终端中输入以下命令。

    Bash
    npm start
    
  2. 要确认本地服务器的访问地址,请检查终端输出。您会看到服务器运行在 https://:8080。在浏览器中访问该地址。

  3. 对代码做一点小改动,例如编辑 HTML 文件中的文本或更改 CSS 文件中的颜色。保存更改。

  4. 查看项目文档或终端输出,了解如何查看您的更改。某些项目在保存后会自动刷新,其他项目则需要手动刷新浏览器页面。

    对于本项目,请刷新浏览器窗口以看到更改。

如果 README 未包含所需信息,请检查配置文件获取可用命令。您也可以使用以下提示询问 Copilot Chat

Text
How do I start this project locally?

下一步?

现在您已经成功搭建了第一个本地开发环境,是时候将这些技能运用于不同类型的项目了。

练习另一个项目:尝试为另一个需求不同的项目进行设置。例如,@new2code 的 Python Web 应用使用 Python 和 Flask,而不是 Node.js。

运用本教程所学,您可以

  • 使用 VS Code 克隆仓库
  • 询问 Copilot 需要安装哪些工具和依赖
  • 阅读 README 文件以了解如何运行项目
  • 让应用在浏览器中运行

通过这些练习,您能在不同技术之间识别规律,提升在本地搭建任何项目的信心。

© . This site is unofficial and not affiliated with GitHub, Inc.