上一篇 下一篇 分享链接 返回 返回顶部

新手第一次用 AI 写代码:环境搭建、提问方法和常用命令全流程指南

发布人:慈云数据-客服中心 发布时间:23小时前 阅读量:4

AI编程 新手入门指南|附完整命令

随着大模型技术快速发展,AI 编程已经从“未来趋势”变成了很多开发者、产品经理、运营人员甚至学生都可以直接使用的生产力工具。过去写代码需要从语法、框架、工程结构一点点学起,而现在你可以借助 AI 快速生成代码、解释报错、重构项目、编写测试、生成文档,甚至搭建一个完整的应用原型。

但需要注意的是:AI 编程并不是“完全不用学编程”。它更像是一位随时在线的编程助手,可以帮你提高效率、降低入门门槛,但你仍然需要理解基本概念、会运行命令、能判断代码是否正确。本文将从新手角度出发,带你了解 AI 编程的学习路线、常用工具、开发环境搭建、完整命令示例,以及如何正确向 AI 提问。


一、什么是 AI 编程?

AI 编程,简单来说,就是利用人工智能工具辅助软件开发。它可以帮助你完成以下任务:

  • 根据需求生成代码
  • 解释一段看不懂的代码
  • 查找并修复 Bug
  • 将代码从一种语言转换成另一种语言
  • 自动生成单元测试
  • 优化代码结构和性能
  • 编写项目 README 文档
  • 生成接口文档、数据库设计、前端页面
  • 辅助搭建完整项目

例如,你可以对 AI 说:

请用 Python 写一个爬取网页标题的脚本,并解释每一行代码。

或者:

我有一个 React 项目,运行时报错 Cannot read properties of undefined,请帮我分析原因。

AI 会根据你的描述生成对应的代码或解决方案。


二、新手学习 AI 编程需要掌握什么?

很多人以为使用 AI 编程就不用学基础了,这是一个误区。AI 可以帮你写代码,但你至少需要掌握以下能力:

1. 基础命令行能力

你需要知道如何打开终端、进入文件夹、执行安装命令、启动项目。

常见命令包括:

pwd
ls
cd
mkdir
touch
rm
cp
mv

Windows 用户可以使用 PowerShell,macOS 和 Linux 用户可以使用 Terminal。


2. 至少了解一门编程语言

对于新手来说,推荐从以下两种语言入门:

语言 适合方向 推荐原因
Python 自动化、数据分析、AI 应用、脚本工具 语法简单,生态丰富
JavaScript 前端网页、全栈开发、小程序、Node.js 应用范围广,适合做可视化项目

如果你完全没有基础,建议先学 Python;如果你想做网站或前端页面,可以学习 JavaScript。


3. 会使用代码编辑器

推荐使用 Visual Studio Code,简称 VS Code。它免费、轻量、插件丰富,非常适合新手。

常用插件包括:

  • Chinese Language Pack:中文语言包
  • Python:Python 开发支持
  • ESLint:JavaScript 代码检查
  • Prettier:代码格式化
  • GitHub Copilot:AI 编程辅助
  • Codeium:AI 代码补全工具
  • Continue:开源 AI 编程助手插件

4. 理解项目结构

一个项目通常不只是一个代码文件,而是由多个目录和配置文件组成。例如:

my-project/
├── src/
│   └── main.py
├── README.md
├── requirements.txt
└── .gitignore

你需要理解每个文件的大致作用:

  • src/:存放源代码
  • README.md:项目说明文档
  • requirements.txt:Python 依赖列表
  • .gitignore:告诉 Git 哪些文件不需要提交

三、AI 编程常用工具推荐

1. ChatGPT

ChatGPT 适合:

  • 生成代码
  • 解释代码
  • 规划项目
  • 设计接口
  • 修复报错
  • 编写技术文档
  • 辅助学习编程概念

使用技巧是:不要只问一句“帮我写个程序”,而要提供清晰背景、目标、技术栈和限制条件。


2. GitHub Copilot

GitHub Copilot 可以在编辑器中自动补全代码。你输入函数名、注释或部分代码,它会预测并生成后续代码。

适合已经开始写代码的人使用。


3. Cursor

Cursor 是一款面向 AI 编程的编辑器,基于 VS Code 修改而来。它的特点是可以直接读取整个项目上下文,适合进行项目级别的代码修改。

常见使用场景:

  • 让 AI 理解整个项目
  • 批量修改代码
  • 自动修复错误
  • 生成页面或组件
  • 重构旧项目

4. Continue

Continue 是 VS Code 中常用的开源 AI 编程插件,可以连接不同的大模型服务,用于代码问答、生成和修改。


5. 通义灵码、豆包 MarsCode 等国产工具

如果你更习惯中文环境,也可以使用国内的 AI 编程工具。这些工具通常对中文提示词支持较好,适合初学者使用。


四、开发环境搭建:从零开始

下面分别介绍 Python 和 JavaScript 两套常见环境。


第一部分:Python AI 编程入门

1. 检查是否安装 Python

打开终端,输入:

python --version

如果没有反应,可以尝试:

python3 --version

正常情况下会看到类似输出:

Python 3.12.2

如果没有安装,请到 Python 官网下载安装:

https://www.python.org/

安装时 Windows 用户务必勾选:

Add Python to PATH

2. 创建项目目录

mkdir ai-python-demo
cd ai-python-demo

3. 创建虚拟环境

虚拟环境可以让每个项目拥有独立的依赖,避免不同项目之间互相影响。

Windows:

python -m venv venv

macOS / Linux:

python3 -m venv venv

4. 激活虚拟环境

Windows PowerShell:

.\venv\Scripts\Activate.ps1

Windows CMD:

venv\Scripts\activate

macOS / Linux:

source venv/bin/activate

激活后,你会看到命令行前面多出类似:

(venv)

5. 创建 Python 文件

touch main.py

如果你是 Windows,并且 touch 命令不可用,可以使用:

echo. > main.py

6. 编写第一个 AI 辅助程序

你可以让 AI 生成一个简单的命令行计算器:

提示词示例:

请用 Python 写一个命令行计算器,支持加减乘除。
要求:
1. 使用函数封装;
2. 用户可以连续输入;
3. 输入 q 退出;
4. 对除数为 0 的情况进行处理;
5. 给出完整代码,并解释每一部分。

AI 可能生成如下代码:

def add(a, b):
    return a + b


def subtract(a, b):
    return a - b


def multiply(a, b):
    return a * b


def divide(a, b):
    if b == 0:
        return "错误:除数不能为 0"
    return a / b


def calculator():
    print("欢迎使用 Python 命令行计算器")
    print("支持操作:+、-、*、/")
    print("输入 q 退出程序")

    while True:
        user_input = input("请输入表达式,例如 1 + 2:")

        if user_input.lower() == "q":
            print("程序已退出")
            break

        try:
            parts = user_input.split()
            if len(parts) != 3:
                print("输入格式错误,请使用:数字 运算符 数字")
                continue

            num1 = float(parts[0])
            operator = parts[1]
            num2 = float(parts[2])

            if operator == "+":
                result = add(num1, num2)
            elif operator == "-":
                result = subtract(num1, num2)
            elif operator == "*":
                result = multiply(num1, num2)
            elif operator == "/":
                result = divide(num1, num2)
            else:
                result = "不支持的运算符"

            print("计算结果:", result)

        except ValueError:
            print("请输入有效数字")


if __name__ == "__main__":
    calculator()

运行命令:

python main.py

macOS / Linux 如果默认 Python 版本不对,可以使用:

python3 main.py

7. 安装第三方库

例如,你想让 AI 帮你写一个天气查询工具,可能需要使用 requests 库。

安装命令:

pip install requests

如果使用 Python3:

pip3 install requests

查看已安装依赖:

pip list

导出依赖:

pip freeze > requirements.txt

以后别人拿到项目后,可以使用:

pip install -r requirements.txt

8. Python 项目常用完整命令汇总

# 创建项目
mkdir ai-python-demo
cd ai-python-demo

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境:Windows PowerShell
.\venv\Scripts\Activate.ps1

# 激活虚拟环境:macOS / Linux
source venv/bin/activate

# 创建文件
touch main.py

# 安装依赖
pip install requests

# 查看依赖
pip list

# 导出依赖
pip freeze > requirements.txt

# 运行项目
python main.py

# 退出虚拟环境
deactivate

第二部分:JavaScript / Node.js AI 编程入门

如果你想做网页、小工具、前端项目、接口服务,那么 JavaScript 是非常重要的选择。


1. 检查 Node.js 是否安装

输入:

node -v

再输入:

npm -v

如果输出类似:

v20.11.1
10.2.4

说明安装成功。

如果没有安装,请访问:

https://nodejs.org/

建议安装 LTS 长期支持版本。


2. 创建 Node.js 项目

mkdir ai-node-demo
cd ai-node-demo
npm init -y

执行后会生成:

package.json

这是 Node.js 项目的配置文件。


3. 创建入口文件

touch index.js

Windows 可使用:

echo. > index.js

4. 编写第一个 Node.js 程序

可以向 AI 提问:

请用 Node.js 写一个命令行待办事项程序。
要求:
1. 可以添加任务;
2. 可以查看任务列表;
3. 可以标记任务完成;
4. 使用数组保存数据;
5. 给出完整代码和运行方式。

示例代码:

const readline = require("readline");

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
});

let todos = [];

function showMenu() {
  console.log("\n待办事项程序");
  console.log("1. 添加任务");
  console.log("2. 查看任务");
  console.log("3. 完成任务");
  console.log("4. 退出");
}

function askQuestion() {
  showMenu();

  rl.question("请选择操作:", function (answer) {
    if (answer === "1") {
      rl.question("请输入任务内容:", function (task) {
        todos.push({
          text: task,
          done: false,
        });
        console.log("任务已添加");
        askQuestion();
      });
    } else if (answer === "2") {
      if (todos.length === 0) {
        console.log("暂无任务");
      } else {
        todos.forEach((todo, index) => {
          console.log(
            `${index + 1}. [${todo.done ? "x" : " "}] ${todo.text}`
          );
        });
      }
      askQuestion();
    } else if (answer === "3") {
      rl.question("请输入要完成的任务编号:", function (num) {
        const index = Number(num) - 1;
        if (todos[index]) {
          todos[index].done = true;
          console.log("任务已完成");
        } else {
          console.log("任务不存在");
        }
        askQuestion();
      });
    } else if (answer === "4") {
      console.log("程序已退出");
      rl.close();
    } else {
      console.log("无效选择");
      askQuestion();
    }
  });
}

askQuestion();

运行命令:

node index.js

5. 使用 npm 安装依赖

例如安装 axios

npm install axios

安装开发依赖:

npm install nodemon --save-dev

启动自动重启开发模式:

npx nodemon index.js

6. 修改 package.json 启动脚本

打开 package.json,修改:

{
  "scripts": {
    "start": "node index.js",
    "dev": "nodemon index.js"
  }
}

然后可以使用:

npm run start

或者:

npm run dev

7. Node.js 项目常用完整命令汇总

# 检查版本
node -v
npm -v

# 创建项目
mkdir ai-node-demo
cd ai-node-demo

# 初始化项目
npm init -y

# 创建入口文件
touch index.js

# 安装依赖
npm install axios

# 安装开发依赖
npm install nodemon --save-dev

# 运行文件
node index.js

# 使用 nodemon 运行
npx nodemon index.js

# 使用 npm 脚本运行
npm run start
npm run dev

# 查看已安装包
npm list

# 卸载依赖
npm uninstall axios

第三部分:用 AI 编程的正确提问方式

AI 编程效果好不好,关键在于你的提示词是否清楚。新手常见问题是描述太模糊,例如:

帮我写个网站。

这个问题太宽泛,AI 不知道你要什么类型的网站、用什么技术、有哪些页面、是否需要数据库、是否要登录功能。

更好的提问方式是:

请帮我用 HTML、CSS、JavaScript 写一个个人作品集网站。
要求:
1. 包含首页、关于我、项目展示、联系方式四个区域;
2. 页面风格简洁,适合程序员;
3. 使用响应式布局,手机和电脑都能正常显示;
4. 不使用任何框架;
5. 给出完整代码,并说明每个文件如何保存和运行。

高质量提示词模板

你可以使用下面这个通用模板:

你是一名资深软件工程师,请帮我完成一个编程任务。

【项目目标】
我要做一个:

【技术栈】
使用:

【功能需求】
1.
2.
3.

【限制条件】
1.
2.

【输出要求】
1. 给出完整代码;
2. 说明项目目录结构;
3. 给出运行命令;
4. 解释关键代码;
5. 如果有依赖,请给出安装命令;
6. 如果可能出错,请列出常见错误和解决方法。

示例:

你是一名资深 Python 工程师,请帮我写一个批量重命名图片的脚本。

【项目目标】
将某个文件夹下的 jpg 和 png 图片按顺序重命名为 image_001、image_002。

【技术栈】
Python 3。

【功能需求】
1. 用户输入文件夹路径;
2. 自动识别 jpg、jpeg、png 文件;
3. 按文件名排序;
4. 重命名时保留原扩展名;
5. 避免文件名冲突。

【输出要求】
1. 给出完整代码;
2. 给出运行命令;
3. 解释关键逻辑;
4. 提醒可能的风险。

第四部分:AI 编程的典型工作流

1. 先让 AI 帮你拆解需求

不要一上来就让 AI 写完整项目,而是先问:

我想开发一个记账 App,请帮我拆解功能模块、页面结构、数据表设计和开发步骤。

这样可以先获得整体方案。


2. 再让 AI 生成最小可运行版本

例如:

请先帮我实现一个最小可运行版本,只包含添加账单和查看账单列表,不需要登录,不需要后端,数据先保存在浏览器 localStorage 中。

这叫 MVP,即最小可行产品。新手一定要从小功能开始,不要一开始就做复杂系统。


3. 运行代码并复制报错给 AI

当代码运行失败时,不要只说“报错了”,而要提供完整信息:

我运行 npm run dev 时出现以下错误:

复制完整报错内容……

我的项目结构是:

复制项目结构……

请帮我分析原因,并给出修改后的完整代码。

AI 需要足够上下文才能准确定位问题。


4. 让 AI 解释代码

不要只复制代码运行,而要继续追问:

请逐行解释这段代码,尤其说明每个函数的作用。

或者:

请用适合编程新手的方式解释这段代码,并举一个运行示例。

这样你才能真正提升能力。


5. 让 AI 帮你优化和测试

当功能能跑起来后,可以继续问:

请帮我检查这段代码有哪些问题,包括可读性、异常处理、安全性和性能。

也可以问:

请为这段代码编写单元测试,并告诉我如何运行测试。

第五部分:Git 版本管理入门

AI 编程很容易频繁修改代码,所以一定要学会 Git。Git 可以帮你保存历史版本,防止改坏项目后无法恢复。


1. 检查 Git 是否安装

git --version

如果没有安装,访问:

https://git-scm.com/

2. 初始化仓库

git init

3. 查看文件状态

git status

4. 添加文件到暂存区

git add .

5. 提交代码

git commit -m "初始化项目"

6. 查看提交历史

git log

简洁查看:

git log --oneline

7. 创建 .gitignore 文件

Python 项目常见 .gitignore

venv/
__pycache__/
*.pyc
.env

Node.js 项目常见 .gitignore

node_modules/
.env
dist/

8. Git 常用完整命令汇总

# 检查 Git
git --version

# 初始化仓库
git init

# 查看状态
git status

# 添加全部文件
git add .

# 提交代码
git commit -m "提交说明"

# 查看历史
git log --oneline

# 查看分支
git branch

# 创建并切换分支
git checkout -b feature-demo

# 切换分支
git checkout main

# 合并分支
git merge feature-demo

第六部分:新手常见问题与解决方法

1. AI 生成的代码可以直接用吗?

不建议完全不检查就使用。AI 生成的代码可能存在以下问题:

  • 依赖版本不兼容
  • 忽略异常处理
  • 代码可以运行但逻辑不严谨
  • 存在安全风险
  • 使用了过时 API
  • 没有考虑边界情况

正确做法是:先运行,再测试,再理解,最后修改。


2. 报错时该怎么办?

请按这个顺序处理:

  1. 复制完整报错信息;
  2. 确认当前所在目录;
  3. 检查依赖是否安装;
  4. 检查运行命令是否正确;
  5. 把报错、代码、目录结构一起发给 AI。

你可以问:

下面是我的报错信息和代码,请帮我分析错误原因,并给出一步步解决方案。

3. AI 写的代码太复杂怎么办?

你可以要求它简化:

这段代码对新手来说太复杂了,请用更简单的写法重写,并减少高级语法。

或者:

请保留相同功能,但用最基础的语法实现,方便初学者理解。

4. AI 总是答非所问怎么办?

你需要增加约束:

请不要使用框架,只使用原生 JavaScript。
请只输出完整代码,不要省略任何部分。
请按照我的项目结构修改,不要重新设计整个项目。

第七部分:推荐新手练习项目

以下项目非常适合用 AI 辅助完成:

Python 练习项目

  1. 命令行计算器
  2. 批量重命名文件工具
  3. Excel 数据清洗脚本
  4. 图片压缩工具
  5. 网页标题抓取器
  6. 文件夹自动分类工具
  7. 简单聊天机器人
  8. 天气查询命令行工具

JavaScript 练习项目

  1. 待办事项列表
  2. 计算器网页
  3. 倒计时工具
  4. 个人作品集网站
  5. 记账小应用
  6. Markdown 预览器
  7. 天气查询页面
  8. 简单博客前端页面

第八部分:一个完整 AI 编程实战流程示例

假设你要做一个“待办事项网页”,可以这样和 AI 配合。

第一步:提出需求

请帮我用 HTML、CSS、JavaScript 写一个待办事项网页。
要求:
1. 可以添加任务;
2. 可以删除任务;
3. 可以标记完成;
4. 数据保存在 localStorage;
5. 页面美观简洁;
6. 给出 index.html、style.css、script.js 三个完整文件代码;
7. 给出运行方式。

第二步:创建项目

mkdir todo-web
cd todo-web
touch index.html style.css script.js

Windows:

mkdir todo-web
cd todo-web
echo. > index.html
echo. > style.css
echo. > script.js

第三步:粘贴 AI 生成代码

将 AI 给出的代码分别复制到对应文件中。


第四步:运行项目

如果只是纯前端页面,可以直接双击 index.html 打开。

如果你安装了 VS Code,可以使用 Live Server 插件运行。

也可以用 Node.js 快速启动本地服务:

npx serve .

如果提示安装,输入 y 确认即可。


第五步:提交 Git

git init
git add .
git commit -m "完成待办事项网页初版"

第六步:继续优化

你可以继续问 AI:

请在现有待办事项网页基础上增加任务分类功能,包括工作、学习、生活三个分类。

或者:

请帮我优化页面样式,让它更像现代 Web App。

第九部分:AI 编程学习路线建议

对于零基础新手,可以按下面顺序学习:

第 1 阶段:基础操作

目标:能运行代码。

需要掌握:

  • 命令行基础
  • VS Code 使用
  • Python 或 JavaScript 基础语法
  • 如何安装依赖
  • 如何运行文件

建议练习:

  • 计算器
  • 猜数字游戏
  • 待办事项程序

第 2 阶段:小工具开发

目标:能做实用工具。

需要掌握:

  • 文件读写
  • 网络请求
  • JSON 数据
  • 错误处理
  • 第三方库使用

建议练习:

  • 批量重命名工具
  • 天气查询工具
  • Excel 处理脚本
  • Markdown 转换工具

第 3 阶段:完整项目

目标:能完成一个可展示作品。

需要掌握:

  • 项目结构
  • 前后端基础
  • 数据存储
  • API 调用
  • Git 管理
  • 部署上线

建议练习:

  • 个人博客
  • 作品集网站
  • 记账系统
  • 简单后台管理页面

第 4 阶段:AI 深度协作

目标:让 AI 成为你的长期开发助手。

需要掌握:

  • 高质量提示词
  • 代码审查
  • 自动化测试
  • 项目重构
  • 文档生成
  • 部署运维基础

第十部分:给新手的关键建议

1. 不要追求一次生成完美项目

AI 生成大型项目时容易出错。更好的方式是:

先做小功能,再逐步扩展。

例如先做登录页面,再做注册,再做用户中心,不要一次要求 AI 写完整电商系统。


2. 每次只让 AI 修改一个明确问题

错误示例:

帮我优化整个项目。

更好的方式:

请只优化登录页面的表单校验逻辑,不要修改页面样式。

3. 学会保存可运行版本

每完成一个功能,就提交一次 Git:

git add .
git commit -m "完成登录功能"

这样即使 AI 后面把代码改坏,你也可以回到之前版本。


4. 不要把密钥直接发给 AI

如果你的项目中有 API Key、数据库密码、Token 等敏感信息,不要直接粘贴给 AI,也不要提交到 Git。

应该放在 .env 文件中,并加入 .gitignore

.env

5. 必须学会阅读报错

报错不是敌人,而是线索。常见报错包括:

  • 文件路径错误
  • 依赖未安装
  • 变量未定义
  • 端口被占用
  • 语法错误
  • 版本不兼容

当你能看懂一部分报错时,AI 编程效率会明显提升。


总结

AI 编程极大降低了软件开发的门槛,但它并不是魔法。真正高效的方式是:你负责提出清晰需求、运行验证、判断结果;AI 负责生成代码、解释逻辑、辅助排错和优化方案。

对于新手来说,最推荐的路线是:

  1. 学会命令行和 VS Code;
  2. 选择 Python 或 JavaScript 入门;
  3. 用 AI 辅助完成小项目;
  4. 遇到报错时把完整信息交给 AI 分析;
  5. 学会 Git 保存版本;
  6. 不断让 AI 解释代码,而不是只复制粘贴;
  7. 从小工具逐渐过渡到完整项目。

最后记住一句话:

AI 不会替你成为程序员,但会让你更快成为程序员。

只要你愿意动手运行、不断提问、持续修改,AI 编程会成为你学习开发和提升效率的强大助力。

目录结构
全文