部署Cloud Functions时Cloud Code是否会解析符号链接为实际文件？

是的，你观察到的Cloud Code将符号链接解析为实际文件部署是预期行为，以下是相关细节和官方依据：

行为说明 #

Cloud Code for VS Code在部署Google Cloud Functions时，会自动解析函数目录内的符号链接，将指向的实际文件内容打包到部署包中，而非保留符号链接本身。这是因为Google Cloud Functions的运行环境无法直接识别外部目录的符号链接，必须将所有依赖代码包含在部署包内才能正常执行。

官方依据 #

1. Cloud Code的部署逻辑遵循Google Cloud Functions的核心部署规范：GCF要求所有函数依赖的代码必须位于函数目录或其子目录中，符号链接会被视为指向的实际文件进行打包处理。
2. 在Cloud Code的本地开发与部署文档中明确提到，部署工具会递归收集函数目录下的所有文件资源，包括解析符号链接后的内容，确保部署包包含运行所需的全部代码。

你的场景适配 #

你的目录结构（将通用代码放在外部common目录，通过软链接关联到函数目录）完全符合Cloud Code的设计逻辑，这种方式既实现了多函数共享通用代码，又无需手动复制文件，确实简化了部署流程。

额外注意事项 #

• 若common目录包含多文件或子目录，可直接链接整个目录：ln -s ../common ./function1/common，Cloud Code会自动解析整个目录的内容打包。
• 确保软链接的相对路径准确，避免因路径错误导致部署时文件缺失。

内容的提问来源于stack exchange，提问作者Yu Sato