4. 开发环境搭建：本地开发工具与调试模拟

说实话，很多人在学无服务器架构时，第一步就卡在了环境搭建上。我自己带过不少团队，发现大家最容易犯的错就是——直接在线上环境改代码。嗯，这就像在高速公路上换轮胎，风险太大了。

今天我们就来聊聊，怎么把开发环境搭得既顺手又安全。我会重点讲两个工具：Serverless Framework 和 Funcraft（阿里云官方工具）。

4.1 为什么需要本地开发环境？

你想想看，函数计算的核心是「事件驱动」。你的代码跑在云上，但调试时总不能每次都部署到线上吧？

我曾经有个项目，团队直接在线上改代码，结果一次语法错误导致整个服务挂了20分钟。从那以后，我定了个规矩：本地能跑的代码，才能上云。

本地开发的好处很明显：

• 快速迭代：改完代码立刻能看到效果
• 节省成本：线上调试要消耗计算资源，本地免费
• 安全可控：不会因为调试影响到线上用户

4.2 Serverless Framework：最流行的选择

Serverless Framework 是目前社区最活跃的工具。我用它写过上百个函数，稳定性没得说。

4.2.1 安装与初始化

安装其实就一行命令：

npm install -g serverless

装完之后，你可以用 serverless 或简写 sls 来执行命令。我个人习惯用 sls，少打几个字嘛。

初始化一个项目：

sls create --template aws-nodejs --path my-service
cd my-service

这里我选的是 AWS 的 Node.js 模板。如果你用腾讯云或阿里云，也有对应的模板。

4.2.2 核心配置文件：serverless.yml

这个文件是整个服务的「说明书」。我刚开始用的时候，觉得配置项太多，后来发现其实核心就几个：

service: my-service

provider:
  name: aws
  runtime: nodejs14.x
  region: us-east-1

functions:
  hello:
    handler: handler.hello
    events:
      - http:
          path: hello
          method: get

你看，functions 下面定义了一个叫 hello 的函数。它通过 HTTP 触发，路径是 /hello。

4.2.3 本地调试

Serverless Framework 提供了 sls offline 插件。装上它，你就能在本地模拟 API Gateway 的行为。

npm install --save-dev serverless-offline

然后在 serverless.yml 里加上：

plugins:
  - serverless-offline

启动本地服务：

sls offline start

这时候，你的函数就在本地跑起来了。访问 http://localhost:3000/hello，就能看到结果。

4.3 Funcraft：阿里云用户的利器

如果你用的是阿里云函数计算（FC），那 Funcraft（简称 fun）是官方推荐的工具。我个人觉得它在本地调试方面做得比 Serverless Framework 更细致。

4.3.1 安装与配置

安装方式很简单：

npm install -g @alicloud/fun

装完后需要配置阿里云的密钥：

fun config

它会提示你输入 AccessKey ID 和 Secret。嗯，这里要注意，千万别把密钥提交到代码仓库里。

4.3.2 初始化项目

fun init my-app

它会生成一个模板项目。里面有个 template.yml 文件，类似 Serverless Framework 的配置：

ROSTemplateFormatVersion: '2015-09-01'
Transform: 'Aliyun::Serverless-2018-04-03'
Resources:
  my-service:
    Type: 'Aliyun::Serverless::Service'
    Properties:
      Description: 'This is my service'
    my-function:
      Type: 'Aliyun::Serverless::Function'
      Properties:
        Handler: index.handler
        Runtime: nodejs12
        CodeUri: './'

4.3.3 本地调试：fun local

Funcraft 最让我喜欢的功能就是 fun local。它能在本地启动一个完整的函数计算环境。

fun local start

启动后，你可以用 HTTP 请求来触发函数。比如：

curl http://localhost:8000/2016-08-15/proxy/my-service/my-function/

我在项目中遇到过一个问题：本地调试时一切正常，但部署到线上就报错。后来发现是本地和线上的 Node.js 版本不一致。所以，一定要确保本地环境和线上环境一致。

4.4 调试技巧与避坑指南

调试无服务器应用和传统应用不太一样。我总结了几条经验：

4.4.1 日志是最好的朋友

别指望断点调试。函数计算是分布式的，你没法像调试单体应用那样一步步跟。所以，多打日志。

module.exports.handler = async (event) => {
  console.log('Received event:', JSON.stringify(event));
  // 你的业务逻辑
  console.log('Processing result:', result);
  return result;
};

我曾经因为少打一行日志，花了两小时排查一个参数传递的问题。从那以后，我每个函数至少打三行日志：入口、关键步骤、出口。

4.4.2 模拟事件源

不同的触发器会传递不同格式的事件。比如 API Gateway 和 OSS 的事件结构完全不一样。你可以用工具来模拟：

• Serverless Framework：sls invoke local --function hello --path event.json
• Funcraft：fun local invoke my-function --event event.json

这里的 event.json 就是模拟的事件数据。你可以从云平台的文档里找到示例。

4.4.3 环境变量管理

别把敏感信息硬编码在代码里。用环境变量来管理：

# serverless.yml
provider:
  environment:
    DB_HOST: ${env:DB_HOST}
    DB_PASSWORD: ${env:DB_PASSWORD}

本地调试时，可以在 .env 文件里设置这些变量。但记得把 .env 加到 .gitignore 里。

4.5 总结

环境搭建这件事，说白了就是「磨刀不误砍柴工」。花点时间把本地工具配好，后面开发效率能提升好几倍。

我个人建议：

• 如果你用 AWS，首选 Serverless Framework
• 如果你用阿里云，首选 Funcraft
• 不管用哪个，本地调试一定要跑通再部署

下一章我们会聊到函数计算的触发器配置。到时候你会发现，今天搭的环境就是后面所有实验的基础。