VB / Python / SQL 三语言对照

ArcGIS

编程语法规范速览

VB / Python / SQL 三语言对照

日常开发 / 语法避坑 / 字符规范

一、三种语言的角色定位

ArcGIS 的二次开发与日常数据处理依赖三种语言,适用场景各不相同。

建议: 新项目一律采用 Python + ArcPy 方案;SQL 用于企业级数据库直接读写。

二、大小写敏感性

其中: 文件地理数据库 / 企业数据库 SQL 关键字不区分大小写,但字段名是否区分与平台有关。

•Oracle: 表名、字段名不区分大小写,但内容区分

•PostgreSQL / SQL Server: 均为小写形式存储,需使用双引号保留原始大小写

实战注意: Python 中 ArcPy 函数和参数名称严格区分大小写。使用代码补全工具可以避免拼写错误。

import arcpy

# 正确: 函数名首字母大写

arcpy.analysis.Buffer("roads", "roads_buf", "100 Meters")

# 函数名拼写错误会抛 NameError 或 AttributeError

三、引号使用规则

3.1 数字不加引号,字符串加引号

三类语言都遵循此通用规则。

# 正确: 数字不加引号

arcpy.analysis.Buffer("roads", "roads_buf", 100)  # 100 是数值

# 注意: 部分工具需要字符串参数时反而会报错

3.2 三种语言对字符串引号的不同要求

3.3 嵌套引号的处理

当字符串内部需要包含引号时,需要转义或使用不同引号。

# Python: 用反斜杠转义或换用另一种引号

label = "He's a student"   # 双引号包裹,内部单引号

# SQL: 字符串内嵌引号用两个连续单引号

SELECT * FROM cities WHERE name = 'O''Brien'

四、半角字符与全角字符

重要原则: ArcGIS 编程语言要求使用半角字符(英文标点),而不是全角字符(中文标点)。全角符号会导致 SyntaxError 或语法解析失败。

4.1 容易混淆的字符对照

4.2 典型错误案例

坑:复制粘贴导致全角: 从网页、Word、PDF 复制的代码经常带入全角符号,例如中文逗号 ',' 或全角冒号 ':' 在 Python 中会被当作非法字符而直接报错。

# 错误: 使用了全角逗号(Chinese comma)

arcpy.analysis.Buffer("roads","roads_buf",100)  # SyntaxError

# 正确: 全部使用半角符号

arcpy.analysis.Buffer("roads", "roads_buf", 100)

4.3 调试方法

•将代码复制到记事本(或 Notepad++),使用「显示所有字符」功能

•在编辑器中将字体设置为 Consolas / Courier New,便于区分全角与半角

•使用专业代码编辑器(VS Code、PyCharm)的高亮提示功能

•若提示 invalid character,首先检查不可见字符:制表符、空格、零宽字符

五、语法错误排查技巧

5.1 常见错误信号

5.2 标准排查流程

出现语法错误,建议按以下流程排查:

•第一步: 将代码复制到记事本,仔细观察每一个标点

•第二步: 用开发工具重新输入,避免隐藏字符干扰

•第三步: 从最小可运行代码开始,逐段添加定位问题

•第四步: 使用 print() / arcpy.AddMessage() 打印中间结果

•第五步: 对比 Esri 帮助文档中的官方示例确认语法

5.3 三语言对照速记

— 文档结束 —